Admin

Administrative endpoints (requires bearer token authentication)

Create or update registry entries

post

https://asset-bundle-registry.decentraland.org/

/registry

Administrative endpoint for manually creating or updating registry entries. This endpoint fetches entity data from Catalyst and asset bundle status from the CDN to populate the registry.

Use this endpoint to manually trigger registry updates for specific entities that may have been missed by the event-driven pipeline.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication for administrative endpoints. The token must match the API_ADMIN_TOKEN environment variable configured on the server.

Body

application/json

entityIdsstring[]Required

List of entity IDs (CIDs) to add or update in the registry

Responses

200

Registry operation result

application/json

400

Bad request - no entity IDs provided

application/json

401

Unauthorized - missing or invalid bearer token

application/json

post

/registry

HTTPcURLJavaScriptPython

POST /registry HTTP/1.1
Host: asset-bundle-registry.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "entityIds": [
    "text"
  ]
}

{
  "successes": [
    {}
  ],
  "failures": [
    {
      "entityId": "text",
      "error": "text"
    }
  ]
}

Flush internal caches

delete

https://asset-bundle-registry.decentraland.org/

/flush-cache

Administrative endpoint for flushing internal job caches. This clears cached job status information stored in Redis/memory.

Use this endpoint to reset cache state when troubleshooting or after manual database modifications.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication for administrative endpoints. The token must match the API_ADMIN_TOKEN environment variable configured on the server.

Responses

200

Cache flush result

application/json

401

Unauthorized - missing or invalid bearer token

application/json

delete

/flush-cache

HTTPcURLJavaScriptPython

DELETE /flush-cache HTTP/1.1
Host: asset-bundle-registry.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "message": "text"
}