You can send and receive the following request and response payloads to create assets on Roblox. For information on the usage of the API, see the [Usage Guide](/cloud/open-cloud/usage-assets).

Creates an asset with provided content and metadata. Requires both **Read** and **Write** for API key permissions. Requires **asset:read** and **asset:write** scopes for OAuth 2.0 apps. 

Create Asset

Creates an asset with provided content and metadata.

Updates an asset with provided content and metadata. Currently can only update **Models**. Requires both **Read** and **Write** for API key permissions. Requires **asset:read** and **asset:write** scopes for OAuth 2.0 apps.

Update Asset

Updates an asset with provided content and metadata.

Get the result of an asset creation or update using the returned Operation ID. Requires **Read** for the API key permission and **asset:read** for OAuth 2.0 apps.

Get Operation

Get the result of an asset creation or update.

Contains an arbitrary serialized message along with a `@type` that describes the type of the serialized message.

The unique identifier of the asset. Required for [Update Asset](#PATCH-v1-assets-_asset_).

The asset type. Can only be `Audio`, `Decal`, or `Model`. Required for [Create Asset](#POST-v1-assets).

CreationContext

The description of the asset. Limit to 1000 characters. Required for [Create Asset](#POST-v1-assets).

The asset name. Required for [Create Asset](#POST-v1-assets).

ModerationResult

The returned resource path of the asset. Format: `assets/{assetId}`. Example: `assets/2205400862`.

The creation timestamp of the current revision.

The revision ID of the asset. Every change of the asset automatically commits a new version. The format is an integer string. Example: `1`.

Asset

The context of creation that is not part of the asset content, such as metadata and creator information. Required for [Create Asset](#POST-v1-assets).

Creator

Expected asset upload fee in Robux. When the actual price is more than expected, the operation fails with a 400 error.

The Group ID. Required if the asset is group-owned.

The User ID the creator. Required if the asset is individual-user-owned.

The moderation state of the asset. Can be `MODERATION_STATE_REVIEWING`, `MODERATION_STATE_REJECTED`, or `MODERATION_STATE_APPROVED`.

This resource represents a long-running operation that is the result of a network API call.

If `false`, the operation is still in progress. If `true`, the operation is completed.

Status

The server-assigned resource path. The default format is `operations/{operation_id}`.

Operation

The logical error model explaining the error status.

A list of messages carrying error details.

Assets API

Overview

Guides

Tutorials

Reference

Resources

Design

Engine

Avatar

Cloud

Per API Key: {maxInPeriod} requests every {periodInSeconds} seconds per IP Address

The following API key permissions are required to call this endpoint. For more
information on generating proper keys, see [Managing API Keys]({apiKeyReferenceDocLink}).

The following endpoints are available at paths relative to the base URL.

A JSON value can be `null`, `boolean`, `string`, `number`, `array`, or `object`.

The following scopes are required for your OAuth 2.0 application to use this endpoint. For more information on how to register an OAuth 2.0 application, see [App Registration and Review]({oauth2ReferenceDocLink}).

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

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

This allows viewing information about your groups.

This allows you to manage group join requests for your account.

This allows viewing information about your inventory.

This grants the ability to publish messages on behalf of users.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

Grants the ability to read place information.

Grants the ability to edit place information.

This operation grants access to publish new versions of experiences to Roblox.

Grants the ability to read experience information.

Grants the ability to edit experience information.

Grants the ability to read user's premium and verified status.

This allows you to view a user's social accounts.

This enables Single Sign-On functionality

This grants access to read your profile information

Default Value: {defaultValueStart}{defaultValueEnd}

This function returns immediately if possible, but can yield the thread that called it until it can return a value.

This member doesn’t appear in the object browser and is not intended for widespread use.

This member is only accessible only through the command bar. Attempting to access this member from scripts causes an error.

This function can’t pause the Lua thread that called it.

Attempting to access this member in scripts causes an error. You might be able to access this member from Roblox Studio's property window.

This member doesn’t appear in Roblox Studio’s Object Browser.

You can’t create an instance of this class with the Instance.new constructor.

Roblox does not replicate this member across its server-client boundary.

Lua code can’t access this member. You might be able to change its value from the property window in Roblox Studio.

This object’s replication behavior is dependent on the player who owns it.

This member is accessible only through the command bar and plugins only. Attempting to access this member from scripts causes an error.

This property is read-only and is safe to read in unsynchronized threads. Attempting to write to it causes an error.

This member is read only. Attempting to write to this member causes an error.

This member is accessible only in CoreScripts.

Only Roblox CoreScripts can access this member, and it isn’t usable by Players.

You can read and write to this property safely from multiple threads.

This class is a top-level singleton. Retrieve an instance of this class with the GetService function.

Multiple threads can potentially write to this property, so it’s unsafe to read from unsynchronized threads.

This function pauses the Lua thread that called it until it returns a result. This doesn’t interrupt other scripts.

Learn how to create successful content on Roblox with comprehensive guides, code samples, reference, and tutorials.


{pageTitle} | {SiteName}

title

Unable to add to inventory

The code sample {title} has been added to your Inventory.

Version {versionNumber} includes general performance improvements and bug fixes. Check our other release notes for status on specific improvements and bugs.

Please don't include private or personal information. Maximum {maxDescriptionLength} words.

Minimum {minDescriptionLength} words required in the description.

Release Notes for Roblox Studio Version {versionNumber}

We’re making things more awesome. Thanks for your patience.

By clicking "Continue", you will be directed to {redirectLinkStart}{redirectLinkEnd}

This site is not owned or operated by Roblox. They may have different terms and privacy policies.