API Reference
Every public endpoint on the RoCore website, for scripting or integrating externally. Every request needs a valid RoCore license key — get one from your dashboard.
Archive an asset
Archives a Roblox catalog asset you own, taking it off the catalog without deleting it.
x-license-key headerPath parameters
assetIdrequiredstring (numeric)The Roblox catalog asset ID.
Example request
curl -X POST "https://rocore.app/api/assets/{assetId}/archive" \
-H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" Example response
{
"success": true
}Error responses
{"error":"Invalid asset id."}{"error":"A valid license key is required."}{"error":"Asset management is not available right now."}Restore an archived asset
Restores a previously archived Roblox catalog asset, bringing it back onto the catalog.
x-license-key headerPath parameters
assetIdrequiredstring (numeric)The Roblox catalog asset ID.
Example request
curl -X POST "https://rocore.app/api/assets/{assetId}/restore" \
-H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" Example response
{
"success": true
}Error responses
{"error":"Invalid asset id."}{"error":"A valid license key is required."}Grant a universe access to an asset
Grants a Roblox universe (game/experience) permission to use a private asset you own.
x-license-key headerPath parameters
assetIdrequiredstring (numeric)The Roblox catalog asset ID.
Body (JSON)
universeIdrequiredstring (1-20 digit numeric)The Roblox universe ID to grant access to.
Example request
curl -X PATCH "https://rocore.app/api/assets/{assetId}/permissions" \
-H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" \
\
-H "Content-Type: application/json" \
-d '{"universeId":"1234567890"}'Example response
{
"success": true
}Error responses
{"error":"Invalid request body."}{"error":"A valid license key is required."}Set an asset on or off sale
Sets a catalog asset — including UGC Limiteds — on or off sale, immediately or after a delay. Works for classic catalog items, non-limited UGC collectibles, and Limiteds. For a Limited, the item's current per-user purchase cap is read back from Roblox and resent unchanged so it isn't reset.
x-license-key headerBody (JSON)
assetIdrequiredstring (numeric)assetTypeoptionalstring ("catalog", default)onSalerequiredbooleandurationoptionalnumber (seconds)Omit to apply immediately.
priceInRobuxoptionalnumber, 0-1,000,000,000Omit to keep the item's current price.
Example request
curl -X POST "https://rocore.app/api/assets/sale" \
-H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" \
\
-H "Content-Type: application/json" \
-d '{"assetId":"123456789","onSale":true,"priceInRobux":500}'Example response
{
"scheduleId": "cku9f3jz0000108l2g8h0z3q",
"onSale": true,
"appliedImmediately": true,
"executeAt": "2026-01-01T00:00:00.000Z"
}Error responses
{"error":"A valid license key is required."}{"error":"This asset already has a pending sale-status change. Wait for it to finish, or check its status."}Its resale-eligibility setting is sent as the same default Roblox expects for non-limited collectibles, since there's currently no confirmed way to read a Limited's existing resale setting back before writing. Test on a low-stakes item first if that setting matters to you.
Check a scheduled sale change
Checks the status of a previously scheduled on/off-sale change.
x-license-key headerPath parameters
scheduleIdrequiredstringThe id returned by POST /api/assets/sale.
Example request
curl -X GET "https://rocore.app/api/assets/sale/{scheduleId}" \
-H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" Example response
{
"id": "cku9f3jz0000108l2g8h0z3q",
"assetId": "123456789",
"targetOnSale": true,
"priceInRobux": 500,
"status": "APPLIED",
"executeAt": "2026-01-01T00:00:00.000Z",
"appliedAt": "2026-01-01T00:00:00.000Z"
}Get a user's Limiteds inventory
Fetches a Roblox user's Limiteds inventory, with thumbnails and Rolimons value/demand/trend data merged in.
x-license-key headerPath parameters
userIdrequiredstring (numeric)The Roblox user ID.
Example request
curl -X GET "https://rocore.app/api/roblox/users/{userId}/limiteds" \
-H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" Example response
{
"userId": "1234567",
"count": 1,
"totalRap": 50000,
"totalValue": 62000,
"items": [
{
"assetId": "982439",
"userAssetId": "1029384756",
"serialNumber": 42,
"name": "Dominus Frigidus",
"rap": 50000,
"value": 62000,
"acronym": "DF",
"demand": "High",
"trend": "Stable",
"projected": false,
"hyped": false,
"rare": true,
"iconUrl": "https://tr.rbxcdn.com/..."
}
]
}Error responses
{"error":"This user's inventory is not viewable."}{"error":"Roblox user not found."}Check if a user owns an item
Checks whether a Roblox user owns a specific item.
x-license-key headerPath parameters
userIdrequiredstring (numeric)itemTyperequired"Asset" | "Badge" | "GamePass"itemIdrequiredstring (numeric)Example request
curl -X GET "https://rocore.app/api/roblox/users/{userId}/inventory/{itemType}/{itemId}" \
-H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" Example response
{
"userId": "1234567",
"itemType": "Asset",
"itemId": "982439",
"owns": true
}Error responses
{"error":"itemType must be one of: Asset, Badge, GamePass"}{"error":"This user's inventory is not viewable."}Get a Discord member's Spotify status
Returns what a Discord server member is currently listening to on Spotify, if anything. Only reflects servers the RoCore Discord bot has linked via /activate, and only members who've explicitly opted in via /trackspotify — the bot is what actually populates this data, since Discord has no REST way to ask for it directly.
x-license-key headerPath parameters
guildIdrequiredstring (Discord snowflake)discordUserIdrequiredstring (Discord snowflake)Example request
curl -X GET "https://rocore.app/api/discord/spotify-status/{guildId}/{discordUserId}" \
-H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" Example response
{
"listening": true,
"trackName": "Song Title",
"artistName": "Artist Name",
"albumArtUrl": "https://i.scdn.co/image/...",
"trackUrl": "https://open.spotify.com/track/...",
"startedAt": "2026-01-01T00:00:00.000Z",
"endsAt": "2026-01-01T00:03:30.000Z",
"updatedAt": "2026-01-01T00:00:05.000Z"
}When not listening, returns { listening: false, reason } instead of an error — reason is "not_opted_in" (never ran /trackspotify, or turned it off) or "not_listening" (opted in, just nothing playing right now).
Process due scheduled sales
Applies every due scheduled sale change. Internal — called by Vercel Cron and a GitHub Actions poller, not meant for manual use.
Authorization: Bearer <CRON_SECRET>Example request
curl -X GET "https://rocore.app/api/cron/process-asset-sales" \
-H "Authorization: Bearer <CRON_SECRET>" Example response
{
"processed": 3,
"succeeded": 3,
"failed": 0
}