/
RO
roblox
Search skmtc…
⌘K
Docs
Sign in
Docs
History
Schema
Generate
Filter operations
Accounts
198
Advertising
25
Analytics
27
Assets
138
get
/asset-delivery-api/v1/assetId/{assetId}
Retrieves an asset by its ID with OpenCloud auth.
get
/asset-delivery-api/v1/assetId/{assetId}/version/{versionNumber}
Retrieves an asset by its ID and version number with OpenCloud auth.
patch
/asset-permissions-api/v1/assets/permissions
Grant a subject permission to multiple assets. Authorization is required to grant permissions to the subject and asset IDs in the request.
post
/assets/v1/assets
Creates an asset with provided content and metadata.
get
/assets/v1/assets/{assetId}
Retrieve specific asset metadata. Include the `readMask` parameter for additional asset metadata.
patch
/assets/v1/assets/{assetId}
Updates an asset with provided content and metadata.
get
/assets/v1/assets/{assetId}/versions
List Asset Versions of an Asset
get
/assets/v1/assets/{assetId}/versions/{versionNumber}
Get Asset Version
post
/assets/v1/assets/{assetId}/versions:rollback
Rollback an asset to a previous version.
post
/assets/v1/assets/{assetId}:archive
Archives the asset.
patch
/assets/v1/assets/{assetId}:multipartUpload
Starts a multipart upload operation to update assets.
post
/assets/v1/assets/{assetId}:restore
Restores an archived asset.
post
/assets/v1/assets:multipartUpload
Starts a multipart upload operation to create assets.
get
/assets/v1/operations/{operationId}
Get the result of an asset creation or update.
delete
/assets/v1/operations/{operationId}:multipartUpload
Abort a multipart asset upload.
post
/assets/v1/operations/{operationId}:multipartUploadChunkComplete
Records a chunk upload complete.
post
/assets/v1/operations/{operationId}:multipartUploadComplete
Records a multipart upload complete and returns a URL to poll the status.
post
/cloud/v2/universes/{universe_id}:generateSpeechAsset
Generate Speech Asset
get
/cloud/v2/users/{user_id}/asset-quotas
List Asset Quotas
get
/legacy-localization-tables/v1/localization-table/tables/{assetId}
Get table information by the assetId of the table.
post
/legacy-publish/v1/badges/{badgeId}/icon
Overwrites a badge icon with a new one.
get
/toolbox-service/v2/assets/{id}
Get Creator Store Asset Details
get
/toolbox-service/v2/assets:search
Search Creator Store Assets
get
/v1/alias/{universeId}/{assetName}
Retrieves an asset by its alias (universeID/name)
get
/v1/asset
get
/v1/asset-quotas
List asset quotas of the given resource type and asset type.
get
/v1/asset-thumbnail-animated
Thumbnails asset animated.
get
/v1/asset-to-category
Lists a mapping for assets to category IDs to convert from inventory ID to catalog ID. Creates a mapping to link 'Get More' button in inventory page to the relevant catalog page.
get
/v1/asset-to-subcategory
Lists a mapping for assets to subcategory IDs to convert from inventory ID to catalog ID. Creates a mapping to link 'Get More' button in inventory page to the relevant catalog page.
get
/v1/asset-types/{assetType}/agents
Gets agents of type requestModel.AgentType who are allowed to perform requestModel.ActionType for assetType.
get
/v1/assetId/{assetId}
Retrieves an asset by its ID
get
/v1/assetId/{assetId}/version/{versionNumber}
Retrieves an asset by its ID and version number.
get
/v1/assets
Thumbnails assets.
get
/v1/assets-thumbnail-3d
Thumbnails assets.
post
/v1/assets/batch
get
/v1/assets/voting
Gets the voting information of the given assets
get
/v1/assets/{assetId}/bundles
Lists the bundles a particular asset belongs to. Use the Id of the last bundle in the response to get the next page.
get
/v1/assets/{assetId}/resale-data
Gets asset resale data.
post
/v1/audio
Published an audio file and returns the new asset info.
post
/v1/audio/verify
Verifies an audio file and returns a product that you can purchase to publish the audio file.
post
/v1/avatar-item-updates/create-context
Mint an avatar item update context (parent operation) for an existing catalog item. Studio threads the returned operationId as the ParentOperationId of the staging asset upload.
post
/v1/badges/{badgeId}/icon
Overwrites a badge icon with a new one.
post
/v1/badges/{badgeId}/icon#publish.roblox.com
Overwrites a badge icon with a new one.
post
/v1/bundles
Create a new bundle with the provided information.
post
/v1/bundles/create-context
Generate bundle creation context which is necessary for the bundle creation process.
get
/v1/bundles/details
Returns details about the given bundleIds.
get
/v1/bundles/metadata
Get metadata for bundle creation and publishing.
get
/v1/bundles/status/{creationStatusId}
Get status on the CreateBundle request that was previously queued up.
get
/v1/bundles/{bundleId}/details
Returns details about the given bundleId.
get
/v1/bundles/{bundleId}/recommendations
Gets recommendations for a given bundle, bundleId of 0 returns randomized bundles - Accepts both public and authenticated users.
post
/v1/catalog/items/details
Returns details for one or more catalog items.
post
/v1/catalog/items/details/complete
Returns list of item details complete with user ownership and economy information. Batch version of GetItemDetailsComplete. Items with critical errors are returned in ItemErrors with their corresponding HTTP status code (404 for not-found, 500 for other errors).
get
/v1/categories
Lists Category Names and their Ids.
post
/v1/collectibles
Publishes a given target as a Collectible.
patch
/v1/collectibles/bulk-update
Updates some items in bulk.
get
/v1/collectibles/check-item-configuration-access
Checks the configure access permissions.
get
/v1/collectibles/check-item-publish-access
Checks the publish access permissions.
get
/v1/collectibles/check-item-upload-access
Checks the upload access permissions.
get
/v1/collectibles/commission-rates
Get commission rates for collectibles.
get
/v1/collectibles/metadata
Gets metadata for Collectibles publishing.
get
/v1/collectibles/price-floor
Get the price floor for a given item.
get
/v1/collectibles/publishing-fees
Gets the publishing fee required to publish a collectible item.
get
/v1/collectibles/publishing-fees/preview
Previews the publishing fee for an item type before the item exists, so the fee can be shown at upload time. Takes the item's type directly instead of a target id.
get
/v1/collectibles/regional-pricing/preview
Get the preview for regional prices.
get
/v1/collectibles/regional-pricing/representative-countries
Get the representative countries for regional pricing.
get
/v1/collectibles/rental-pricing/preview
Gets the rental pricing preview for a collectible item. Can include regional pricing if enabled.
get
/v1/collectibles/revenue-split
Get Revenue Split for collectibles.
patch
/v1/collectibles/update-item-display-information
Update the display information of an item.
patch
/v1/collectibles/{collectibleItemId}
Update product information about a published Collectible Item.
post
/v1/collectibles/{collectibleItemId}/restock
Restock a published limited collectible item by adding additional quantity.
get
/v1/collectibles/{collectibleItemId}/restock-eligibility
Returns structured restock eligibility information for a given collectible item. This is the single source of truth the frontend should use to determine whether restocking is available, instead of re-deriving from individual flags.
get
/v1/collectibles/{collectibleItemId}/restocking-fees
Get the restocking fee for a given collectible item and additional quantity.
delete
/v1/collectibles/{collectibleItemId}/sale-schedule
Cancel the collectible item's scheduled on/off sale time.
post
/v1/content-metadata/appeal
Creates a content metadata appeal for an asset.
get
/v1/content-metadata/appeal-status
Checks the appeal status for an asset.
post
/v1/creations/get-asset-details
Gets the asset status and other configuration details for the given assetIds list.
get
/v1/creations/get-assets
Gets the user created asset information filtered by the given asset type.
post
/v1/delist-item
Delists an item, permanently archiving it so it is no longer visible to any users on the marketplace.
get
/v1/favorites/assets/{assetId}/count
Gets the favorite count for the given asset Id.
get
/v1/favorites/bundles/{bundleId}/count
Gets the favorite count for the given bundle Id.
get
/v1/favorites/users/{userId}/assets/{assetId}/favorite
Gets the favorite model for the asset and user.
post
/v1/favorites/users/{userId}/assets/{assetId}/favorite
Create a favorite for an asset by the authenticated user.
delete
/v1/favorites/users/{userId}/assets/{assetId}/favorite
Delete a favorite for an asset by the authenticated user.
get
/v1/favorites/users/{userId}/bundles/{bundleId}/favorite
Gets the favorite model for the bundle and user.
post
/v1/favorites/users/{userId}/bundles/{bundleId}/favorite
Create a favorite for the bundle by the authenticated user.
delete
/v1/favorites/users/{userId}/bundles/{bundleId}/favorite
Delete favorite for the bundle by the authenticated user.
get
/v1/favorites/users/{userId}/favorites/{assetTypeId}/assets
Lists the marketplace assets favorited by a given user with the given assetTypeId.
get
/v1/favorites/users/{userId}/favorites/{subtypeId}/bundles
Lists the bundles favorited by a given user with the given bundle subtypeId.Switched to EAAS style pagination cursors since July 2024.
get
/v1/folders
Gets all folders belonging to the User or a Group.
post
/v1/folders
Creates a new folder.
get
/v1/folders/{folderId}
Get a specific folder by its ID.
delete
/v1/folders/{folderId}
Deletes a folder.
patch
/v1/folders/{folderId}
Updates folder details.
get
/v1/folders/{folderId}/items
Gets the contents of a specific folder.
post
/v1/folders/{folderId}/items
Adds one or more items to a folder.
delete
/v1/folders/{folderId}/items
Removes one or more items from a folder.
post
/v1/games/{gameId}/thumbnail/image
Uploads a game thumbnail.
get
/v1/items
Get an item by its id.
get
/v1/items/by-creator
Gets the marketplace items for a creator by item type (e.g. bundle, asset).
get
/v1/items/by-token
Gets the marketplace items for a token (i.e. an IEC avatar creation token).
get
/v1/items/categories
Gets a category hierarchy (by category domain) used to render category chips, e.g. on the creator dashboard.
get
/v1/items/price-floor
Get the price floor.
get
/v1/items/upload-fee
Get the upload fee for an item type.
get
/v1/localization-table/tables/{assetId}
Get table information by the assetId of the table.
get
/v1/marAssetHash/{marAssetHash}/marCheckSum/{marCheckSum}
Retrieves an asset by its mar (moderation agnostic) hash and mar (moderation agnostic) checksum.
get
/v1/permissions/action-allowed-for-item-type
Returns whether the authenticated user (or group on their behalf) may perform the given marketplace action for a specific asset, bundle, or look type.
get
/v1/permissions/groups
Returns a list of allowed groups for a given Roblox.ItemConfiguration.Api.Enums.MarketplaceAction.
get
/v1/permissions/item-types
Gets item types which the requested action can be performed on.
get
/v1/plugins
Gets plugin details by ids.
patch
/v1/plugins/{pluginId}
Updates a plugin.
post
/v1/plugins/{pluginId}/icon
Overwrites a plugin icon with a new one.
get
/v1/preferences/publishing
post
/v1/preferences/publishing
delete
/v1/preferences/publishing
patch
/v1/preferences/publishing
get
/v1/products/{productId}
Retrieves the product purchasable details given its id.
get
/v1/subcategories
Lists Subcategory Names and their Ids.
post
/v1/topic/get-topics
Gets topics for a populated request, or trending queries when the request has no topic inputs. Topics and queries are mutually exclusive in the response.
get
/v1/user/groups/canmanagegamesoritems
Gets a list of groups a user can manage games or items for.
get
/v1/users/{userId}/bundles
Lists the bundles owned by a given user.
get
/v1/users/{userId}/bundles/{bundleType}
get
/v1/users/{userId}/currently-wearing
Gets a list of asset ids that the user is currently wearing.
get
/v1/users/{userId}/items/{itemType}/{itemTargetId}
Gets owned items of the specified item type. Game Servers can make requests for any user, but can only make requests for game passes that belong to the place sending the request. Place creators can make requests as if they were the Game Server.
get
/v2/alias/{universeId}/{assetName}
get
/v2/asset
get
/v2/assetId/{assetId}
get
/v2/assetId/{assetId}/version/{versionNumber}
post
/v2/assets/batch
get
/v2/assets/{assetId}/bundles
Lists bundles that contain the given asset (hydrated search-detail shape for marketplace).
get
/v2/assets/{assetId}/owners
Gets a list of owners of an asset.
get
/v2/assets/{id}/versions
Retrieves asset information for the specified asset ID. The authenticated user must be able to manage the asset or granted by package permission.
get
/v2/collectible-items/{collectibleItemId}/owners
Gets a list of owners of a collectible item.
delete
/v2/inventory/asset/{assetId}
Give up an asset owned by the authenticated user. Assets that are created by Roblox user or are limited edition are not eligible for deletion and will return NotEligibleForDelete.
get
/v2/marAssetHash/{marAssetHash}/marCheckSum/{marCheckSum}
get
/v2/search/items/details
Search for catalog items.
get
/v2/users/{userId}/inventory
Get user's inventory by multiple Roblox.Platform.Assets.AssetType.
post
/v3/assets/batch
post
/v3/assets/prewarm
Avatars
36
Badges
29
Bans and blocks
7
Configs
9
Connections
19
Creator Store
8
Data and memory stores
48
Developer products
21
Experiments
11
Game Events
5
Game passes
21
Generative AI
1
Groups
46
Interactions
27
Inventories
9
Localization
96
Luau Execution
5
Matchmaking
32
Metadata
17
Notifications
18
Observability
7
Places
23
Private servers
9
Service Efficiency
2
Team Create
8
Thumbnail Personalization
7
Thumbnails
11
Trades
16
Universes
37
User profiles
5
Users
14
Assets
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to Get the restocking fee for a given collectible item and additional quantity.
get
/v1/collectibles/{collectibleItemId}/restocking-fees
Nov 13, 2026
e1e00fbc18e5
Revision changes
info
endpoint added