For the complete documentation index, see llms.txt. This page is also available as Markdown.

Curations

Collection and item curation workflow

Get all collection curations

get
/curations

Returns all collection curations

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 curations

application/json
okbooleanOptional
get/curations
GET /v1/curations 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",
      "collection_id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "pending",
      "assignee": "text",
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Get collection curation

get
/collections/{id}/curation

Returns the curation for a collection

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

Collection UUID

Responses
200

Collection curation

application/json
okbooleanOptional
get/collections/{id}/curation
GET /v1/collections/{id}/curation 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",
    "collection_id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "pending",
    "assignee": "text",
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
}

Create collection curation

post
/collections/{id}/curation

Creates a new curation for a collection

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

Collection UUID

Body
assigneestringOptional
Responses
200

Curation created successfully

No content

post/collections/{id}/curation
POST /v1/collections/{id}/curation HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "assignee": "text"
}

No content

Update collection curation

patch
/collections/{id}/curation

Updates a collection curation

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

Collection UUID

Body
statusstring · enumOptionalPossible values:
assigneestringOptional
Responses
200

Curation updated successfully

No content

patch/collections/{id}/curation
PATCH /v1/collections/{id}/curation HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "status": "pending",
  "assignee": "text"
}

No content

Create curation forum post

post
/collections/{id}/curation/post

Creates a forum post for curation assignee change

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

Collection UUID

Body
objectOptional
Responses
200

Forum post created successfully

No content

post/collections/{id}/curation/post
POST /v1/collections/{id}/curation/post HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

No content

Get collection item curations

get
/collections/{id}/itemCurations

Returns item curations for a collection

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

Collection UUID

Query parameters
itemIdsstring[]Optional
Responses
200

List of item curations

No content

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

No content

Get item curation

get
/items/{id}/curation

Returns the curation for an item

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

Item UUID

Responses
200

Item curation

No content

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

No content

Create item curation

post
/items/{id}/curation

Creates a new curation for an item

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

Item UUID

Responses
200

Curation created successfully

No content

post/items/{id}/curation
POST /v1/items/{id}/curation HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

No content

Update item curation

patch
/items/{id}/curation

Updates an item curation

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

Item UUID

Body
statusstring · enumOptionalPossible values:
Responses
200

Curation updated successfully

No content

patch/items/{id}/curation
PATCH /v1/items/{id}/curation HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "status": "pending"
}

No content

Last updated