Asset Packs

Asset pack management

Get all asset packs

get

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/assetPacks

Returns asset packs for the user or default packs

Query parameters

ownerstringOptional

Use "default" for default packs or user address

Responses

200

List of asset packs

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

get

/assetPacks

HTTPcURLJavaScriptPython

GET /v1/assetPacks HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

{
  "ok": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "thumbnail": "text",
      "eth_address": "text",
      "assets": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "asset_pack_id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "model": "text",
          "script": "text",
          "thumbnail": "text",
          "tags": [
            "text"
          ],
          "category": "text",
          "contents": {},
          "metrics": {},
          "parameters": [],
          "actions": []
        }
      ],
      "created_at": "2026-01-20T21:20:23.252Z",
      "updated_at": "2026-01-20T21:20:23.252Z"
    }
  ]
}

Get an asset pack

get

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/assetPacks/{id}

Returns an asset pack by ID

Path parameters

idstring · uuidRequired

Responses

200

Asset pack details

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

get

/assetPacks/{id}

HTTPcURLJavaScriptPython

GET /v1/assetPacks/{id} HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "thumbnail": "text",
    "eth_address": "text",
    "assets": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "asset_pack_id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "model": "text",
        "script": "text",
        "thumbnail": "text",
        "tags": [
          "text"
        ],
        "category": "text",
        "contents": {},
        "metrics": {},
        "parameters": [],
        "actions": []
      }
    ],
    "created_at": "2026-01-20T21:20:23.252Z",
    "updated_at": "2026-01-20T21:20:23.252Z"
  }
}

Create or update an asset pack

put

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/assetPacks/{id}

Creates a new asset pack or updates an existing one

Authorizations

SignedFetch

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idstring · uuidRequired

Body

application/json

idstring · uuidRequired

titlestringRequired

Responses

200

Asset pack created/updated successfully

No content

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

put

/assetPacks/{id}

HTTPcURLJavaScriptPython

PUT /v1/assetPacks/{id} HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 297

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "assets": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "asset_pack_id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "model": "text",
      "script": "text",
      "thumbnail": "text",
      "tags": [
        "text"
      ],
      "category": "text",
      "contents": {},
      "metrics": {}
    }
  ]
}

No content

Delete an asset pack

delete

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/assetPacks/{id}

Deletes an asset pack

Authorizations

SignedFetch

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idstring · uuidRequired

Responses

200

Asset pack deleted successfully

No content

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

delete

/assetPacks/{id}

HTTPcURLJavaScriptPython

DELETE /v1/assetPacks/{id} HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

No content

Upload asset pack thumbnail

post

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/assetPacks/{id}/thumbnail

Uploads a thumbnail for an asset pack

Authorizations

SignedFetch

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idstring · uuidRequired

Body

multipart/form-data

thumbnailstring · binaryOptional

Responses

200

Thumbnail uploaded successfully

No content

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

post

/assetPacks/{id}/thumbnail

HTTPcURLJavaScriptPython

POST /v1/assetPacks/{id}/thumbnail HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 22

{
  "thumbnail": "binary"
}

No content