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

401

Unauthorized - authentication required or insufficient permissions

application/json

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-03-03T22:30:49.907Z",
      "updated_at": "2026-03-03T22:30:49.907Z"
    }
  ]
}

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

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

409

Conflict - resource already exists or is in an invalid state

application/json

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-03-03T22:30:49.907Z",
    "updated_at": "2026-03-03T22:30:49.907Z"
  }
}

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

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

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

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

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

401

Unauthorized - authentication required or insufficient permissions

application/json

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

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

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

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

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

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

409

Conflict - resource already exists or is in an invalid state

application/json

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

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

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

PreviousItems NextCommittee

Last updated 2 months ago

hashtagGet all collection curations

hashtagGet collection curation

hashtagCreate collection curation

hashtagUpdate collection curation

hashtagCreate curation forum post

hashtagGet collection item curations

hashtagGet item curation

hashtagCreate item curation

hashtagUpdate item curation

Get all collection curations

Get collection curation

Create collection curation

Update collection curation

Create curation forum post

Get collection item curations

Get item curation

Create item curation

Update item curation