Projects

Scene project management

Get all project templates

get

/templates

Returns all public project templates

Responses

200

List of project templates

application/json

get

/templates

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

200

List of project templates

{
  "ok": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "description": "text",
      "thumbnail": "text",
      "scene_id": "123e4567-e89b-12d3-a456-426614174000",
      "eth_address": "text",
      "cols": 1,
      "rows": 1,
      "parcels": 1,
      "transforms": 1,
      "gltf_shapes": 1,
      "nft_shapes": 1,
      "scripts": 1,
      "entities": 1,
      "is_deleted": true,
      "is_public": true,
      "is_template": true,
      "creation_coords": "text",
      "template_status": "active",
      "video": "text",
      "created_at": "2026-01-22T01:03:12.500Z",
      "updated_at": "2026-01-22T01:03:12.500Z"
    }
  ]
}

Get all projects

get

/projects

Returns all projects for the authenticated user

Authorizations

X-Identity-Auth-Chain-*stringRequired

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

Responses

200

List of projects

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

get

/projects

GET /v1/projects HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "description": "text",
      "thumbnail": "text",
      "scene_id": "123e4567-e89b-12d3-a456-426614174000",
      "eth_address": "text",
      "cols": 1,
      "rows": 1,
      "parcels": 1,
      "transforms": 1,
      "gltf_shapes": 1,
      "nft_shapes": 1,
      "scripts": 1,
      "entities": 1,
      "is_deleted": true,
      "is_public": true,
      "is_template": true,
      "creation_coords": "text",
      "template_status": "active",
      "video": "text",
      "created_at": "2026-01-22T01:03:12.500Z",
      "updated_at": "2026-01-22T01:03:12.500Z"
    }
  ]
}

Get a project

get

/projects/{id}

Returns a specific project by ID

Authorizations

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

Project UUID

Responses

200

Project details

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

get

/projects/{id}

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

{
  "ok": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "description": "text",
    "thumbnail": "text",
    "scene_id": "123e4567-e89b-12d3-a456-426614174000",
    "eth_address": "text",
    "cols": 1,
    "rows": 1,
    "parcels": 1,
    "transforms": 1,
    "gltf_shapes": 1,
    "nft_shapes": 1,
    "scripts": 1,
    "entities": 1,
    "is_deleted": true,
    "is_public": true,
    "is_template": true,
    "creation_coords": "text",
    "template_status": "active",
    "video": "text",
    "created_at": "2026-01-22T01:03:12.500Z",
    "updated_at": "2026-01-22T01:03:12.500Z"
  }
}

Create or update a project

put

/projects/{id}

Creates a new project or updates an existing one

Authorizations

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

Project UUID

Body

idstring · uuidRequired

titlestringRequired

descriptionstringRequired

thumbnailstringOptional

scene_idstring · uuidRequired

colsintegerRequired

rowsintegerRequired

is_publicbooleanOptional

creation_coordsstringOptional

is_templatebooleanOptional

template_statusstring · enumOptionalPossible values:

videostringOptional

Responses

200

Project created/updated successfully

application/json

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

put

/projects/{id}

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

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "description": "text",
  "thumbnail": "text",
  "scene_id": "123e4567-e89b-12d3-a456-426614174000",
  "cols": 1,
  "rows": 1,
  "is_public": true,
  "creation_coords": "text",
  "is_template": true,
  "template_status": "active",
  "video": "text"
}

{
  "ok": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "description": "text",
    "thumbnail": "text",
    "scene_id": "123e4567-e89b-12d3-a456-426614174000",
    "eth_address": "text",
    "cols": 1,
    "rows": 1,
    "parcels": 1,
    "transforms": 1,
    "gltf_shapes": 1,
    "nft_shapes": 1,
    "scripts": 1,
    "entities": 1,
    "is_deleted": true,
    "is_public": true,
    "is_template": true,
    "creation_coords": "text",
    "template_status": "active",
    "video": "text",
    "created_at": "2026-01-22T01:03:12.500Z",
    "updated_at": "2026-01-22T01:03:12.500Z"
  }
}

Delete a project

delete

/projects/{id}

Soft deletes a project

Authorizations

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

Project UUID

Responses

200

Project deleted successfully

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

delete

/projects/{id}

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

No content

Get a public project

get

/projects/{id}/public

Returns a public project by ID (no authentication required)

Path parameters

idstring · uuidRequired

Project UUID

Responses

200

Public project details

application/json

404

Resource not found

application/json

get

/projects/{id}/public

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

{
  "ok": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "description": "text",
    "thumbnail": "text",
    "scene_id": "123e4567-e89b-12d3-a456-426614174000",
    "eth_address": "text",
    "cols": 1,
    "rows": 1,
    "parcels": 1,
    "transforms": 1,
    "gltf_shapes": 1,
    "nft_shapes": 1,
    "scripts": 1,
    "entities": 1,
    "is_deleted": true,
    "is_public": true,
    "is_template": true,
    "creation_coords": "text",
    "template_status": "active",
    "video": "text",
    "created_at": "2026-01-22T01:03:12.500Z",
    "updated_at": "2026-01-22T01:03:12.500Z"
  }
}

Upload project media

post

/projects/{id}/media

Uploads media files (thumbnails, previews) for a project

Authorizations

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

Project UUID

Body

thumbnailstring · binaryOptional

previewstring · binaryOptional

northstring · binaryOptional

eaststring · binaryOptional

southstring · binaryOptional

weststring · binaryOptional

Responses

200

Media uploaded successfully

401

Unauthorized - authentication required or insufficient permissions

application/json

post

/projects/{id}/media

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

{
  "thumbnail": "binary",
  "preview": "binary",
  "north": "binary",
  "east": "binary",
  "south": "binary",
  "west": "binary"
}

No content

Get project media file

get

/projects/{id}/media/{filename}

Redirects to the S3 URL for the media file

Path parameters

idstring · uuidRequired

Project UUID

filenamestringRequired

Responses

301

Redirect to S3 URL

404

Resource not found

application/json

get

/projects/{id}/media/{filename}

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

No content

Get project content

get

/projects/{id}/contents/{content}

Returns project content by hash. For preview hash, returns entity object. For CRDT hash, redirects to CRDT file.

Path parameters

idstring · uuidRequired

Project UUID

contentstringRequired

Responses

200

Entity object (for preview hash)

application/json

301

Redirect to content URL

302

Redirect to CRDT file

400

Bad request - invalid input

application/json

404

Resource not found

application/json

get

/projects/{id}/contents/{content}

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

{}

Get project preview info

get

/projects/{id}/about

Returns realm configuration for project preview

Path parameters

idstring · uuidRequired

Project UUID

Responses

200

Preview configuration

application/json

get

/projects/{id}/about

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

200

Preview configuration

{}

Get project CRDT

get

/projects/{id}/crdt

Returns the CRDT file for the project

Authorizations

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

Project UUID

Responses

302

Redirect to CRDT file

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

get

/projects/{id}/crdt

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

No content

Upload project CRDT

put

/projects/{id}/crdt

Uploads the CRDT file for a project

Authorizations

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

Project UUID

Body

filestring · binaryOptional

Responses

200

CRDT uploaded successfully

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

put

/projects/{id}/crdt

PUT /v1/projects/{id}/crdt HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

No content

Remove coords from projects

delete

/projects/{coords}/coords

Removes creation coordinates from all projects with the given coords

Authorizations

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

coordsstringRequired

Responses

200

Coordinates removed successfully

401

Unauthorized - authentication required or insufficient permissions

application/json

delete

/projects/{coords}/coords

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

No content

PreviousApp NextPools

Last updated 23 days ago

hashtagGet all project templates

hashtagGet all projects

hashtagGet a project

hashtagCreate or update a project

hashtagDelete a project

hashtagGet a public project

hashtagUpload project media

hashtagGet project media file

hashtagGet project content

hashtagGet project preview info

hashtagGet project CRDT

hashtagUpload project CRDT

hashtagRemove coords from projects

Get all project templates

Get all projects

Get a project

Create or update a project

Delete a project

Get a public project

Upload project media

Get project media file

Get project content

Get project preview info

Get project CRDT

Upload project CRDT

Remove coords from projects