Roblox Audio Asset API Documentation

Request Format

The request must be sent as JSON with the following format:

{
    "type": "batching",
    "data": [
        "assetId1",
        "assetId2",
        ...
    ],
    "cookie": "optional-roblosecurity-cookie"
}
    

Parameters:

• type: The type of the request. Must be "batching".
• data: An array of asset IDs that you want to request.
• cookie: Optional. A .ROBLOSECURITY cookie. If not provided, you will only be able to access public assets. The cookie is used once to make the request to Roblox servers and is then discarded permanently. You can find more information on obtaining your cookie here!

Rate Limit

There is a limit of 25 requests per minute. If this limit is exceeded, the following error will be returned:

{
	"code": 429,
	"error": "Rate limit exceeded",
	"status": "error"
}
		

Response Format

The response will be in JSON format:

{
	"type": "batching-response",
	"data": {
		"assetId1": {
			"status": "success",
			"url": "location_of_asset",
		},
		"assetId2": {
			"status": "failure",
			"code": error_code,
			"message": "error_message",
			"additional": "additional_information"
		}
	}
}

	

Fields:

• type: Always "batching-response".
• data: An object where each key is an asset ID and the value contains the result of the request.
• status: Either "success" or "failure".
• url: The location of the asset if the request was successful, or an empty string if it failed.
• additional: Any additional information, such as error messages.

Example Request

POST /
Content-Type: application/json

{
	"type": "batching",
	"data": [
		"1837070127",
		"1842241530",
		"1838857104",
		"123412341234",
		"114870793726467"
	]
}
    

Example Response

{
	"type": "batching-response",
	"data": {
		"1837070127": {
			"status": "success",
			"url": "https://c6.rbxcdn.com/bfe94941622e26b7a7553ebd31cdbbd4"
		},
		"1838857104": {
			"status": "success",
			"url": "https://c4.rbxcdn.com/fa7eef8201e25978df17cccc955849b8"
		},
		"1842241530": {
			"status": "success",
			"url": "https://c1.rbxcdn.com/d12b63528d0039017313f0ee8eeb2f88"
		},
		"123412341234": {
			"status": "failure",
			"code": 404,
			"message": "Not Found",
			"additional": "The requested page could not be found but may be available again in the future."
		},
		"114870793726467": {
			"status": "failure",
			"code": 403,
			"message": "Forbidden",
			"additional": "The request was a legal request, but the server is refusing to respond to it."
		}
	}
}