Projects

Scene project management

Get all project templates

get

/templates

Returns all public project templates

Responses

200

List of project templates

application/json

okbooleanOptional

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-07-10T19:16:36.112Z",
      "updated_at": "2026-07-10T19:16:36.112Z"
    }
  ]
}

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

okbooleanOptional

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-07-10T19:16:36.112Z",
      "updated_at": "2026-07-10T19:16:36.112Z"
    }
  ]
}

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

okbooleanOptional

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-07-10T19:16:36.112Z",
    "updated_at": "2026-07-10T19:16:36.112Z"
  }
}

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

okbooleanOptional

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-07-10T19:16:36.112Z",
    "updated_at": "2026-07-10T19:16:36.112Z"
  }
}

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

No content

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

okbooleanOptional

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-07-10T19:16:36.112Z",
    "updated_at": "2026-07-10T19:16:36.112Z"
  }
}

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

No content

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

No content

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

objectOptional

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

objectOptional

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

No content

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

No content

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

No content

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 6 months ago