Sign in

v1

latestOpenAPI 3.0.42026-08-068161,1253.1 MB
Assets

Retrieves an asset by its ID with OpenCloud auth.

Returns an object containing a location property which is a temporary CDN URL for the asset content. All asset types are supported. You should request that URL with the Accept-Encoding: gzip header and decompress the result if the response is gzipped. If you are using cURL, the --compressed flag will automate these steps for you. This endpoint is expected to be called with API key authentication through apis.roblox.com/asset-delivery-api/v1/assetId/{assetId}. While you are able to make requests to this endpoint with Cookie authentication via assetdelivery.roblox.com/v1/openCloud/assetId/{assetId}, we highly discourage use this way. Expect unannounced removal of this second route in the future.

get/asset-delivery-api/v1/assetId/{assetId}

Path parameters

assetIdinteger required

The ID of the asset to retrieve.

Query parameters

skipSigningScriptsboolean

Whether to skip script signing for the returned asset. Used for script assets that don't require signing.

clientInsertinteger

Set to 1 to indicate this is a client insert request.

scriptinsertinteger

Set to 1 to indicate this is a script insert request.

modulePlaceIdinteger

The place ID of the module making the request.

serverplaceidinteger

The server place ID making the request.

expectedAssetTypestring

The expected asset type as a fallback when assetType header is not provided.

doNotFallbackToBaselineRepresentationboolean

Whether to prevent fallback to baseline representation when specific content representations are not available.

contentRepresentationPriorityListstring

Base64URL-encoded JSON string specifying the priority list of desired content representations (format, version, fidelity).

accessContextstring
usageContextinteger

Headers

Accept-Encodingstring

The Accept-Encoding header value specifying compression formats (e.g., "gzip, deflate"). Defaults to "gzip, deflate" if not provided.

Roblox-Place-Idinteger

The Roblox-Place-Id header value identifying the place making the request.

AssetTypestring

The AssetType header value specifying the expected asset type.

Acceptstring

The Accept header value specifying the preferred response content type.

AssetFormatstring

The AssetFormat header value specifying the desired asset format. Overridden by robloxAssetFormat if both are provided.

Roblox-AssetFormatstring

The Roblox-AssetFormat header value specifying the preferred Roblox-specific asset format. Takes precedence over assetFormat.

Response

OK