Skip to content
Developer docs

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.

POST

Archive an asset

Archives a Roblox catalog asset you own, taking it off the catalog without deleting it.

Auth: x-license-key header
Rate limit: 20 requests / 10 min per IP

Path parameters

assetIdrequiredstring (numeric)

The Roblox catalog asset ID.

Example request

cURL
curl -X POST "https://rocore.app/api/assets/{assetId}/archive" \
  -H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" 

Example response

200 OK
{
  "success": true
}

Error responses

400{"error":"Invalid asset id."}
401{"error":"A valid license key is required."}
503{"error":"Asset management is not available right now."}
POST

Restore an archived asset

Restores a previously archived Roblox catalog asset, bringing it back onto the catalog.

Auth: x-license-key header
Rate limit: 20 requests / 10 min per IP

Path parameters

assetIdrequiredstring (numeric)

The Roblox catalog asset ID.

Example request

cURL
curl -X POST "https://rocore.app/api/assets/{assetId}/restore" \
  -H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" 

Example response

200 OK
{
  "success": true
}

Error responses

400{"error":"Invalid asset id."}
401{"error":"A valid license key is required."}
PATCH

Grant a universe access to an asset

Grants a Roblox universe (game/experience) permission to use a private asset you own.

Auth: x-license-key header
Rate limit: 20 requests / 10 min per IP

Path 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
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

200 OK
{
  "success": true
}

Error responses

400{"error":"Invalid request body."}
401{"error":"A valid license key is required."}
POST

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.

Auth: x-license-key header
Rate limit: 20 requests / 1 min per IP

Body (JSON)

assetIdrequiredstring (numeric)
assetTypeoptionalstring ("catalog", default)
onSalerequiredboolean
durationoptionalnumber (seconds)

Omit to apply immediately.

priceInRobuxoptionalnumber, 0-1,000,000,000

Omit to keep the item's current price.

Example request

cURL
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

200 OK
{
  "scheduleId": "cku9f3jz0000108l2g8h0z3q",
  "onSale": true,
  "appliedImmediately": true,
  "executeAt": "2026-01-01T00:00:00.000Z"
}

Error responses

401{"error":"A valid license key is required."}
409{"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.

GET

Check a scheduled sale change

Checks the status of a previously scheduled on/off-sale change.

Auth: x-license-key header
Rate limit: none

Path parameters

scheduleIdrequiredstring

The id returned by POST /api/assets/sale.

Example request

cURL
curl -X GET "https://rocore.app/api/assets/sale/{scheduleId}" \
  -H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" 

Example response

200 OK
{
  "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

Get a user's Limiteds inventory

Fetches a Roblox user's Limiteds inventory, with thumbnails and Rolimons value/demand/trend data merged in.

Auth: x-license-key header
Rate limit: 20 requests / 10 min per IP

Path parameters

userIdrequiredstring (numeric)

The Roblox user ID.

Example request

cURL
curl -X GET "https://rocore.app/api/roblox/users/{userId}/limiteds" \
  -H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" 

Example response

200 OK
{
  "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

403{"error":"This user's inventory is not viewable."}
404{"error":"Roblox user not found."}
GET

Check if a user owns an item

Checks whether a Roblox user owns a specific item.

Auth: x-license-key header
Rate limit: 30 requests / 10 min per IP

Path parameters

userIdrequiredstring (numeric)
itemTyperequired"Asset" | "Badge" | "GamePass"
itemIdrequiredstring (numeric)

Example request

cURL
curl -X GET "https://rocore.app/api/roblox/users/{userId}/inventory/{itemType}/{itemId}" \
  -H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" 

Example response

200 OK
{
  "userId": "1234567",
  "itemType": "Asset",
  "itemId": "982439",
  "owns": true
}

Error responses

400{"error":"itemType must be one of: Asset, Badge, GamePass"}
403{"error":"This user's inventory is not viewable."}
GET

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.

Auth: x-license-key header
Rate limit: 30 requests / 1 min per IP

Path parameters

guildIdrequiredstring (Discord snowflake)
discordUserIdrequiredstring (Discord snowflake)

Example request

cURL
curl -X GET "https://rocore.app/api/discord/spotify-status/{guildId}/{discordUserId}" \
  -H "x-license-key: ROCORE-XXXX-XXXX-XXXX-XXXX" 

Example response

200 OK
{
  "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).

GET

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.

Auth: Authorization: Bearer <CRON_SECRET>
Rate limit: none (protected by the cron secret alone)

Example request

cURL
curl -X GET "https://rocore.app/api/cron/process-asset-sales" \
  -H "Authorization: Bearer <CRON_SECRET>" 

Example response

200 OK
{
  "processed": 3,
  "succeeded": 3,
  "failed": 0
}