/

Docs
History
Schema
Generate

Filter operations

Accounts198

Advertising25

Analytics27

Assets138

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/permissionsGrant a subject permission to multiple assets. Authorization is required to grant permissions to the subject and asset IDs in the request.
post/assets/v1/assetsCreates 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}/versionsList Asset Versions of an Asset
get/assets/v1/assets/{assetId}/versions/{versionNumber}Get Asset Version
post/assets/v1/assets/{assetId}/versions:rollbackRollback an asset to a previous version.
post/assets/v1/assets/{assetId}:archiveArchives the asset.
patch/assets/v1/assets/{assetId}:multipartUploadStarts a multipart upload operation to update assets.
post/assets/v1/assets/{assetId}:restoreRestores an archived asset.
post/assets/v1/assets:multipartUploadStarts 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}:multipartUploadAbort a multipart asset upload.
post/assets/v1/operations/{operationId}:multipartUploadChunkCompleteRecords a chunk upload complete.
post/assets/v1/operations/{operationId}:multipartUploadCompleteRecords a multipart upload complete and returns a URL to poll the status.
post/cloud/v2/universes/{universe_id}:generateSpeechAssetGenerate Speech Asset
get/cloud/v2/users/{user_id}/asset-quotasList 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}/iconOverwrites a badge icon with a new one.
get/toolbox-service/v2/assets/{id}Get Creator Store Asset Details
get/toolbox-service/v2/assets:searchSearch Creator Store Assets
get/v1/alias/{universeId}/{assetName}Retrieves an asset by its alias (universeID/name)
get/v1/asset
get/v1/asset-quotasList asset quotas of the given resource type and asset type.
get/v1/asset-thumbnail-animatedThumbnails asset animated.
get/v1/asset-to-categoryLists 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-subcategoryLists 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}/agentsGets 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/assetsThumbnails assets.
get/v1/assets-thumbnail-3dThumbnails assets.
post/v1/assets/batch
get/v1/assets/votingGets the voting information of the given assets
get/v1/assets/{assetId}/bundlesLists 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-dataGets asset resale data.
post/v1/audioPublished an audio file and returns the new asset info.
post/v1/audio/verifyVerifies an audio file and returns a product that you can purchase to publish the audio file.
post/v1/avatar-item-updates/create-contextMint 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}/iconOverwrites a badge icon with a new one.
post/v1/badges/{badgeId}/icon#publish.roblox.comOverwrites a badge icon with a new one.
post/v1/bundlesCreate a new bundle with the provided information.
post/v1/bundles/create-contextGenerate bundle creation context which is necessary for the bundle creation process.
get/v1/bundles/detailsReturns details about the given bundleIds.
get/v1/bundles/metadataGet 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}/detailsReturns details about the given bundleId.
get/v1/bundles/{bundleId}/recommendationsGets recommendations for a given bundle, bundleId of 0 returns randomized bundles - Accepts both public and authenticated users.
post/v1/catalog/items/detailsReturns details for one or more catalog items.
post/v1/catalog/items/details/completeReturns 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/categoriesLists Category Names and their Ids.
post/v1/collectiblesPublishes a given target as a Collectible.
patch/v1/collectibles/bulk-updateUpdates some items in bulk.
get/v1/collectibles/check-item-configuration-accessChecks the configure access permissions.
get/v1/collectibles/check-item-publish-accessChecks the publish access permissions.
get/v1/collectibles/check-item-upload-accessChecks the upload access permissions.
get/v1/collectibles/commission-ratesGet commission rates for collectibles.
get/v1/collectibles/metadataGets metadata for Collectibles publishing.
get/v1/collectibles/price-floorGet the price floor for a given item.
get/v1/collectibles/publishing-feesGets the publishing fee required to publish a collectible item.
get/v1/collectibles/publishing-fees/previewPreviews 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/previewGet the preview for regional prices.
get/v1/collectibles/regional-pricing/representative-countriesGet the representative countries for regional pricing.
get/v1/collectibles/rental-pricing/previewGets the rental pricing preview for a collectible item. Can include regional pricing if enabled.
get/v1/collectibles/revenue-splitGet Revenue Split for collectibles.
patch/v1/collectibles/update-item-display-informationUpdate the display information of an item.
patch/v1/collectibles/{collectibleItemId}Update product information about a published Collectible Item.
post/v1/collectibles/{collectibleItemId}/restockRestock a published limited collectible item by adding additional quantity.
get/v1/collectibles/{collectibleItemId}/restock-eligibilityReturns 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-feesGet the restocking fee for a given collectible item and additional quantity.
delete/v1/collectibles/{collectibleItemId}/sale-scheduleCancel the collectible item's scheduled on/off sale time.
post/v1/content-metadata/appealCreates a content metadata appeal for an asset.
get/v1/content-metadata/appeal-statusChecks the appeal status for an asset.
post/v1/creations/get-asset-detailsGets the asset status and other configuration details for the given assetIds list.
get/v1/creations/get-assetsGets the user created asset information filtered by the given asset type.
post/v1/delist-itemDelists an item, permanently archiving it so it is no longer visible to any users on the marketplace.
get/v1/favorites/assets/{assetId}/countGets the favorite count for the given asset Id.
get/v1/favorites/bundles/{bundleId}/countGets the favorite count for the given bundle Id.
get/v1/favorites/users/{userId}/assets/{assetId}/favoriteGets the favorite model for the asset and user.
post/v1/favorites/users/{userId}/assets/{assetId}/favoriteCreate a favorite for an asset by the authenticated user.
delete/v1/favorites/users/{userId}/assets/{assetId}/favoriteDelete a favorite for an asset by the authenticated user.
get/v1/favorites/users/{userId}/bundles/{bundleId}/favoriteGets the favorite model for the bundle and user.
post/v1/favorites/users/{userId}/bundles/{bundleId}/favoriteCreate a favorite for the bundle by the authenticated user.
delete/v1/favorites/users/{userId}/bundles/{bundleId}/favoriteDelete favorite for the bundle by the authenticated user.
get/v1/favorites/users/{userId}/favorites/{assetTypeId}/assetsLists the marketplace assets favorited by a given user with the given assetTypeId.
get/v1/favorites/users/{userId}/favorites/{subtypeId}/bundlesLists the bundles favorited by a given user with the given bundle subtypeId.Switched to EAAS style pagination cursors since July 2024.
get/v1/foldersGets all folders belonging to the User or a Group.
post/v1/foldersCreates 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}/itemsGets the contents of a specific folder.
post/v1/folders/{folderId}/itemsAdds one or more items to a folder.
delete/v1/folders/{folderId}/itemsRemoves one or more items from a folder.
post/v1/games/{gameId}/thumbnail/imageUploads a game thumbnail.
get/v1/itemsGet an item by its id.
get/v1/items/by-creatorGets the marketplace items for a creator by item type (e.g. bundle, asset).
get/v1/items/by-tokenGets the marketplace items for a token (i.e. an IEC avatar creation token).
get/v1/items/categoriesGets a category hierarchy (by category domain) used to render category chips, e.g. on the creator dashboard.
get/v1/items/price-floorGet the price floor.
get/v1/items/upload-feeGet 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-typeReturns 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/groupsReturns a list of allowed groups for a given Roblox.ItemConfiguration.Api.Enums.MarketplaceAction.
get/v1/permissions/item-typesGets item types which the requested action can be performed on.
get/v1/pluginsGets plugin details by ids.
patch/v1/plugins/{pluginId}Updates a plugin.
post/v1/plugins/{pluginId}/iconOverwrites 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/subcategoriesLists Subcategory Names and their Ids.
post/v1/topic/get-topicsGets 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/canmanagegamesoritemsGets a list of groups a user can manage games or items for.
get/v1/users/{userId}/bundlesLists the bundles owned by a given user.
get/v1/users/{userId}/bundles/{bundleType}
get/v1/users/{userId}/currently-wearingGets 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}/bundlesLists bundles that contain the given asset (hydrated search-detail shape for marketplace).
get/v2/assets/{assetId}/ownersGets a list of owners of an asset.
get/v2/assets/{id}/versionsRetrieves 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}/ownersGets 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/detailsSearch for catalog items.
get/v2/users/{userId}/inventoryGet user's inventory by multiple Roblox.Platform.Assets.AssetType.
post/v3/assets/batch
post/v3/assets/prewarm

Avatars36

Badges29

Bans and blocks7

Configs9

Connections19

Creator Store8

Data and memory stores48

Developer products21

Experiments11

Game Events5

Game passes21

Generative AI1

Groups46

Interactions27

Inventories9

Localization96

Luau Execution5

Matchmaking32

Metadata17

Notifications18

Observability7

Places23

Private servers9

Service Efficiency2

Team Create8

Thumbnail Personalization7

Thumbnails11

Trades16

Universes37

User profiles5

Users14

Assets

Changes to Get an item by its id.

get/v1/items

Nov 13, 2026e1e00fbc18e5 Revision changes
- info
  endpoint added