Away 12:12 AM

4 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

GET /v1/assets/{assetId}/versions — assets/v1

List Asset Versions of an Asset

List all versions of a specific asset, with optional pagination.

Endpoint

Method: GET

Path: /v1/assets/{assetId}/versions

Servers:

Parameters

NameLocationRequiredDescription
assetIdpathtrueThe unique identifier of the asset.
maxPageSizequeryfalseSpecifies the number of asset versions to include in the response. Valid values range from 1 to 50 (inclusive). Defaults to 8 when not provided.
pageTokenqueryfalseA token for pagination. The value is obtained from a previous request and allows for retrieving the next page of asset versions.
 
[
  {
    "name": "assetId",
    "in": "path",
    "description": "The unique identifier of the asset.",
    "required": true,
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "maxPageSize",
    "in": "query",
    "description": "Specifies the number of asset versions to include in the response. Valid values range from 1 to 50 (inclusive). Defaults to 8 when not provided.",
    "schema": {
      "type": "integer"
    }
  },
  {
    "name": "pageToken",
    "in": "query",
    "description": "A token for pagination. The value is obtained from a previous request and allows for retrieving the next page of asset versions.",
    "schema": {
      "type": "string"
    }
  }
]

Responses

StatusDescription
200Asset versions listed successfully.
400Bad request - invalid parameters.
403Forbidden - API key without Read scope or user doesn't have access.
404Asset not found.
 
{
  "200": {
    "description": "Asset versions listed successfully.",
    "content": {
      "application/json": {
        "schema": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/AssetVersion"
          }
        }
      }
    }
  },
  "400": {
    "description": "Bad request - invalid parameters."
  },
  "403": {
    "description": "Forbidden - API key without Read scope or user doesn't have access."
  },
  "404": {
    "description": "Asset not found."
  }
}

Authentication

{
  "security": [
    {
      "roblox-api-key": [
        "asset:read"
      ]
    },
    {
      "roblox-oauth2": [
        "asset:read"
      ]
    }
  ],
  "securitySchemes": {
    "roblox-api-key": {
      "type": "apiKey",
      "description": "A configurable key that allows granular access to Roblox resources. See https://create.roblox.com/docs/cloud/auth/api-keys for more information.",
      "in": "header",
      "name": "x-api-key"
    },
    "roblox-oauth2": {
      "type": "oauth2",
      "description": "Build or authorize apps to access Roblox resources. See https://create.roblox.com/docs/cloud/auth/oauth2-overview for more information.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://apis.roblox.com/oauth/v1/authorize",
          "tokenUrl": "https://apis.roblox.com/oauth/v1/token",
          "refreshUrl": "https://apis.roblox.com/oauth/v1/token",
          "scopes": {
            "asset:read": "This allows viewing information about your assets.",
            "asset:write": "This allows uploading and updating assets to Roblox."
          }
        }
      }
    }
  }
}

Complete Operation Definition

{
  "tags": [
    "Assets"
  ],
  "x-roblox-cloud-api-operation": true,
  "x-roblox-cloud-api-operation-name": "List Asset Versions",
  "x-roblox-stability": "BETA",
  "summary": "List Asset Versions of an Asset",
  "description": "List all versions of a specific asset, with optional pagination.",
  "operationId": "listAssetVersions",
  "parameters": [
    {
      "name": "assetId",
      "in": "path",
      "description": "The unique identifier of the asset.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "maxPageSize",
      "in": "query",
      "description": "Specifies the number of asset versions to include in the response. Valid values range from 1 to 50 (inclusive). Defaults to 8 when not provided.",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "pageToken",
      "in": "query",
      "description": "A token for pagination. The value is obtained from a previous request and allows for retrieving the next page of asset versions.",
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Asset versions listed successfully.",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetVersion"
            }
          }
        }
      }
    },
    "400": {
      "description": "Bad request - invalid parameters."
    },
    "403": {
      "description": "Forbidden - API key without Read scope or user doesn't have access."
    },
    "404": {
      "description": "Asset not found."
    }
  },
  "security": [
    {
      "roblox-api-key": [
        "asset:read"
      ]
    },
    {
      "roblox-oauth2": [
        "asset:read"
      ]
    }
  ],
  "x-roblox-scopes": [
    {
      "name": "asset:read"
    }
  ],
  "x-roblox-cloud-api-operation-code-samples": [
    {
      "language": "List Asset Versions",
      "script": "curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions?pageToken=&maxPageSize=' \\\n--header 'x-api-key: {apiKey}'"
    }
  ]
}