Assets

Individual 3D asset management

Upload asset files

post

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

/assetPacks/{assetPackId}/assets/{id}/files

Uploads files for an asset in 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

assetPackIdstring · uuidRequired

idstring · uuidRequired

Body

multipart/form-data

objectOptional

Responses

200

Files uploaded successfully

No content

401

Unauthorized - authentication required or insufficient permissions

application/json

post

/assetPacks/{assetPackId}/assets/{id}/files

HTTPcURLJavaScriptPython

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

{}

No content

Get a single asset

get

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

/assets/{id}

Returns an asset by ID

Path parameters

idstring · uuidRequired

Responses

200

Asset details

application/json

okbooleanOptional

404

Resource not found

application/json

get

/assets/{id}

HTTPcURLJavaScriptPython

GET /v1/assets/{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-03-03T22:15:05.747Z",
    "updated_at": "2026-03-03T22:15:05.747Z"
  }
}

Get multiple assets

get

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

/assets

Returns multiple assets by IDs

Query parameters

idone ofRequired

string · uuidOptional

or

string · uuid[]Optional

Responses

200

List of assets

application/json

okbooleanOptional

get

/assets

HTTPcURLJavaScriptPython

GET /v1/assets?id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

200

List of assets

{
  "ok": true,
  "data": [
    {
      "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": []
    }
  ]
}