Assets API

Assets

https://apis.roblox.com/assets

Create Asset

POST /v1/assets

Parameters

request Asset
FormData
Required
fileContent string
FormData
Required

Request

curl

curl --location 'https://apis.roblox.com/assets/v1/assets' \
--header 'x-api-key: ${ApiKey}' \
--form 'request="{
\"assetType\": \"Model\",
\"displayName\": \"Name\",
\"description\": \"This is a description\",
\"creationContext\": {
\"creator\": {
\"userId\": \"${userId}\"
}
}
}"' \
--form 'fileContent=@"/filepath/model.fbx";type=model/fbx'

Response

200 - OK
Returns the Operation ID for checking the creation status.
Returns an object: Operation
path string
metadata Any
done boolean
error Status
response Any

Required Permissions

  • Read
  • Write
  • asset:read
  • asset:write

Limits

Per API Key: 60 requests every 60 seconds per IP Address

Update Asset

PATCH /v1/assets/{assetId}

Parameters

request Asset
FormData
Required
fileContent string
FormData
Required

Request

curl

curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}' \
--header 'x-api-key: ${ApiKey}' \
--form 'request= "{
\"assetId\": ${assetId}},
}"' \
--form 'fileContent=@"/filepath/model.fbx";type=model/fbx'

Response

200 - OK
Returns the Operation ID for checking the update status.
Returns an object: Operation
path string
metadata Any
done boolean
error Status
response Any

Required Permissions

  • Read
  • Write
  • asset:read
  • asset:write

Limits

Per API Key: 60 requests every 60 seconds per IP Address

Get Operation

GET /v1/operations/{operationId}

Request

curl

curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \
--header 'x-api-key: {$ApiKey}'

Response

200 - OK
Returns an object: Operation
path string
metadata Any
done boolean
error Status
response Any

Required Permissions

  • Read
  • asset:read

Limits

Per API Key: 60 requests every 60 seconds per IP Address

Objects

The following objects describe payloads that are accepted or returned. See each individual endpoint for more information on when these objects are used.

Any

Attributes

@type string
Required

Asset

Attributes

assetType string
Required
assetId number
Required
creationContext CreationContext
Required
description string
Required
displayName string
Required
path string
Required
revisionId string
Required
revisionCreateTime string
Required
moderationResult ModerationResult
Required

CreationContext

Attributes

creator Creator
Required
expectedPrice number
Required

Creator

Attributes

userId number
Required
groupId number
Required

ModerationResult

Attributes

moderationState string
Required

Operation

Attributes

path string
Required
metadata Any
Required
done boolean
Required
error Status
Required
response Any
Required

Status

Attributes

code number
Required
message string
Required
details array<Any>
Required