Pools

Public scene pools for community sharing

Get all pools

get

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

/pools

Returns all public scene pools with filtering and pagination

Query parameters

eth_addressstringOptional

groupstringOptional

sort_bystringOptional

Field to sort by

sort_orderstring · enumOptional

Sort order

Possible values:

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

offsetintegerOptional

Offset for pagination

Responses

200

List of pools

application/json

get

/pools

HTTPcURLJavaScriptPython

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

200

List of pools

{
  "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-22T00:47:39.951Z",
      "updated_at": "2026-01-22T00:47:39.951Z",
      "groups": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "likes": 1,
      "like": true
    }
  ]
}

Get a pool

get

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

/projects/{id}/pool

Returns a pool by project ID

Path parameters

idstring · uuidRequired

Project UUID

Responses

200

Pool details

application/json

get

/projects/{id}/pool

HTTPcURLJavaScriptPython

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

200

Pool details

{
  "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-22T00:47:39.951Z",
    "updated_at": "2026-01-22T00:47:39.951Z",
    "groups": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "likes": 1,
    "like": true
  }
}

Create or update a pool

put

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

/projects/{id}/pool

Creates a pool from a project or updates an existing pool

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

Project UUID

Body

application/json

groupsstring · uuid[]Optional

Responses

200

Pool created/updated successfully

No content

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

put

/projects/{id}/pool

HTTPcURLJavaScriptPython

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

{
  "groups": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

No content