Admin

Administrative endpoints (requires bearer token authentication)

Create or update registry entries

post

/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

AuthorizationstringRequired

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

Body

entityIdsstring[]Required

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

Responses

200

Registry operation result

application/json

Result of registry creation/update operation

successesobject[]Required

List of successfully processed entities

400

Bad request - no entity IDs provided

application/json

401

Unauthorized - missing or invalid bearer token

application/json

post/registry

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

/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

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

Result of cache flush operation

okbooleanRequired

Whether the operation succeeded

messagestringRequired

Status message

401

Unauthorized - missing or invalid bearer token

application/json

delete/flush-cache

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

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