Content Server

API endpoints for Decentraland Worlds Content Server

/world/{world_name}/about

get

/world/{world_name}/about

Returns detailed information about a deployed world including scene configuration, comms adapter, and status

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

world_namestringRequired

The name of the world (e.g., my-name.dcl.eth)

Example: my-name.dcl.eth

Responses

200

World information retrieved successfully

application/json

404

World not found

application/json

get

/world/{world_name}/about

GET /world/{world_name}/about HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

{
  "healthy": true,
  "acceptingUsers": true,
  "configurations": {
    "networkId": 1,
    "globalScenesUrn": [
      "text"
    ],
    "scenesUrn": [
      "text"
    ],
    "realmName": "text",
    "minimap": {
      "enabled": true,
      "dataImage": "text",
      "estateImage": "text"
    },
    "map": {
      "minimapEnabled": true,
      "sizes": [
        [
          1
        ]
      ]
    },
    "skybox": {
      "fixedHour": 1,
      "textures": [
        "text"
      ]
    }
  },
  "content": {
    "synchronizationStatus": "text",
    "healthy": true,
    "publicUrl": "text"
  },
  "lambdas": {
    "healthy": true,
    "publicUrl": "text"
  },
  "comms": {
    "healthy": true,
    "protocol": "text",
    "adapter": "text"
  }
}

/entities

post

/entities

Deploy a new scene to a world. The deployment must include entity metadata and all content files. Requires authentication via auth chain.

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Body

entityIdstringRequired

The entity ID (IPFS hash)

Example: bafkreiabi74jam7uh5gmm6x4hox664j53bmt7dy4alrltkhyj3ozcxs2iu

Other propertiesstring · binaryOptional

Content files referenced by the entity

Responses

200

Entity deployed successfully

application/json

400

Invalid request or deployment failed validation

application/json

post

/entities

POST /entities HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 109

{
  "entityId": "bafkreiabi74jam7uh5gmm6x4hox664j53bmt7dy4alrltkhyj3ozcxs2iu",
  "ANY_ADDITIONAL_PROPERTY": "binary"
}

{
  "creationTimestamp": 1,
  "message": "text"
}

/entities/{world_name}

delete

/entities/{world_name}

Remove a deployed scene from a world. Requires signed fetch authentication.

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

world_namestringRequired

The name of the world to undeploy

Example: my-name.dcl.eth

Responses

200

Entity undeployed successfully

No content

401

Unauthorized - invalid signature

application/json

404

World not found

application/json

delete

/entities/{world_name}

DELETE /entities/{world_name} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

No content

/entities/active

post

/entities/active

Retrieve information about active entities based on provided pointers

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Body

pointersstring[]Optional

List of pointers to query

Responses

200

Active entities retrieved successfully

application/json

post

/entities/active

POST /entities/active HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "pointers": [
    "text"
  ]
}

200

Active entities retrieved successfully

[
  {
    "id": "text",
    "type": "text",
    "timestamp": 1,
    "pointers": [
      "text"
    ],
    "content": [
      {
        "file": "text",
        "hash": "text"
      }
    ],
    "metadata": {}
  }
]

/available-content

get

/available-content

Retrieve list of available content hashes

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

Available content retrieved successfully

application/json

get

/available-content

GET /available-content HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

200

Available content retrieved successfully

{
  "cid": [
    "text"
  ]
}

/ipfs/{hashId}

get

/ipfs/{hashId}

Retrieve a content file by its IPFS hash

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

hashIdstringRequired

IPFS hash of the content file

Example: bafkreiabi74jam7uh5gmm6x4hox664j53bmt7dy4alrltkhyj3ozcxs2iu

Responses

200

Content file retrieved successfully

application/octet-stream

Responsestring · binary

404

Content not found

get

/ipfs/{hashId}

GET /ipfs/{hashId} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

binary

/ipfs/{hashId}

head

/ipfs/{hashId}

Check if a content file exists without retrieving it

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

hashIdstringRequired

IPFS hash of the content file

Responses

200

Content exists

No content

404

Content not found

head

/ipfs/{hashId}

HEAD /ipfs/{hashId} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

No content

/contents/{hashId}

get

/contents/{hashId}

Retrieve a content file by its hash

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

hashIdstringRequired

Hash of the content file

Example: bafkreiabi74jam7uh5gmm6x4hox664j53bmt7dy4alrltkhyj3ozcxs2iu

Responses

200

Content file retrieved successfully

application/octet-stream

Responsestring · binary

404

Content not found

get

/contents/{hashId}

GET /contents/{hashId} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

binary

/contents/{hashId}

head

/contents/{hashId}

Check if a content file exists without retrieving it

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

hashIdstringRequired

Hash of the content file

Responses

200

Content exists

No content

404

Content not found

head

/contents/{hashId}

HEAD /contents/{hashId} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

No content

/world/{world_name}/permissions

get

/world/{world_name}/permissions

Retrieve the permissions configuration for a world

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

world_namestringRequired

The name of the world

Example: my-name.dcl.eth

Responses

200

Permissions retrieved successfully

application/json

get

/world/{world_name}/permissions

GET /world/{world_name}/permissions HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

200

Permissions retrieved successfully

{
  "permissions": {
    "deployment": {
      "type": "allow-list",
      "wallets": [
        "text"
      ]
    },
    "access": {
      "type": "unrestricted"
    },
    "streaming": {
      "type": "unrestricted"
    }
  },
  "owner": "0x1234567890123456789012345678901234567890"
}

/world/{world_name}/permissions/{permission_name}

post

/world/{world_name}/permissions/{permission_name}

Set the permission type for a specific permission (deployment, access, or streaming). Requires signed fetch and world ownership.

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

world_namestringRequired

The name of the world

Example: my-name.dcl.eth

permission_namestring · enumRequired

The permission to configure

Possible values:

Body

Responses

204

Permission configured successfully

400

Invalid permission configuration

application/json

401

Unauthorized

application/json

post

/world/{world_name}/permissions/{permission_name}

POST /world/{world_name}/permissions/{permission_name} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "type": "unrestricted"
}

No content

/world/{world_name}/permissions/{permission_name}/{address}

put

/world/{world_name}/permissions/{permission_name}/{address}

Add an Ethereum address to the allow list for a specific permission. Requires signed fetch and world ownership.

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

world_namestringRequired

The name of the world

Example: my-name.dcl.eth

permission_namestring · enumRequired

The permission to modify

Possible values:

addressstringRequired

Ethereum address to add

Example: 0x1234567890123456789012345678901234567890

Responses

204

Address added successfully

400

Invalid request or permission not configured as allow-list

application/json

401

Unauthorized

application/json

put

/world/{world_name}/permissions/{permission_name}/{address}

PUT /world/{world_name}/permissions/{permission_name}/{address} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

No content

/world/{world_name}/permissions/{permission_name}/{address}

delete

/world/{world_name}/permissions/{permission_name}/{address}

Remove an Ethereum address from the allow list for a specific permission. Requires signed fetch and world ownership.

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

world_namestringRequired

The name of the world

Example: my-name.dcl.eth

permission_namestring · enumRequired

The permission to modify

Possible values:

addressstringRequired

Ethereum address to remove

Example: 0x1234567890123456789012345678901234567890

Responses

204

Address removed successfully

400

Invalid request or address not in allow list

application/json

401

Unauthorized

application/json

delete

/world/{world_name}/permissions/{permission_name}/{address}

DELETE /world/{world_name}/permissions/{permission_name}/{address} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

No content

/wallet/{wallet}/stats

get

/wallet/{wallet}/stats

Retrieve storage statistics for a wallet address

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

walletstringRequired

Ethereum wallet address

Example: 0x1234567890123456789012345678901234567890

Responses

200

Wallet statistics retrieved successfully

application/json

400

Invalid wallet address

application/json

get

/wallet/{wallet}/stats

GET /wallet/{wallet}/stats HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

{
  "wallet": "text",
  "dclNames": [
    {
      "name": "text",
      "size": "text"
    }
  ],
  "ensNames": [
    {
      "name": "text",
      "size": "text"
    }
  ],
  "usedSpace": "text",
  "maxAllowedSpace": "text",
  "blockedSince": "2026-01-22T01:22:41.373Z"
}

/wallet/{wallet}/connected-world

get

/wallet/{wallet}/connected-world

Retrieve the world that a wallet is currently connected to

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

walletstringRequired

Ethereum wallet address

Example: 0x1234567890123456789012345678901234567890

Responses

200

Connected world retrieved successfully

application/json

get

/wallet/{wallet}/connected-world

GET /wallet/{wallet}/connected-world HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

200

Connected world retrieved successfully

{
  "world": "text"
}

/wallet/contribute

get

/wallet/contribute

Retrieve list of domains that the authenticated wallet can contribute to. Requires signed fetch.

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

Contributable domains retrieved successfully

application/json

401

Unauthorized

application/json

get

/wallet/contribute

GET /wallet/contribute HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

{
  "domains": [
    {
      "name": "text",
      "user_permissions": [
        "text"
      ],
      "owner": "text",
      "size": "text"
    }
  ],
  "count": 1
}

/status

get

/status

Retrieve the current status of the content server and communication services

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

Server status retrieved successfully

application/json

get

/status

GET /status HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

200

Server status retrieved successfully

{
  "content": {
    "commitHash": "text",
    "worldsCount": {
      "ens": 1,
      "dcl": 1
    }
  },
  "comms": {
    "adapterType": "text",
    "statusUrl": "text",
    "commitHash": "text",
    "users": 1,
    "rooms": 1,
    "timestamp": 1
  }
}

/index

get

/index

Retrieve an index of all deployed worlds

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

Index retrieved successfully

application/json

get

/index

GET /index HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

200

Index retrieved successfully

{
  "index": [
    {
      "name": "text",
      "scenes": [
        {
          "id": "text",
          "title": "text",
          "description": "text",
          "thumbnail": "text",
          "pointers": [
            "text"
          ],
          "timestamp": 1,
          "runtimeVersion": "text"
        }
      ]
    }
  ],
  "timestamp": 1
}

/live-data

get

/live-data

Retrieve live data about active worlds and users

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

Live data retrieved successfully

application/json

get

/live-data

GET /live-data HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

200

Live data retrieved successfully

{
  "worlds": [
    {
      "worldName": "text",
      "users": 1
    }
  ]
}

/get-comms-adapter/{roomId}

post

/get-comms-adapter/{roomId}

Retrieve communication adapter connection string for a room. Requires signed fetch.

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

roomIdstringRequired

Room identifier

Responses

200

Adapter information retrieved successfully

application/json

401

Unauthorized

application/json

post

/get-comms-adapter/{roomId}

POST /get-comms-adapter/{roomId} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

{
  "connectionString": "text"
}

/cast-adapter/{roomId}

post

/cast-adapter/{roomId}

Retrieve cast adapter connection string for a room. Requires signed fetch.

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

roomIdstringRequired

Room identifier

Responses

200

Cast adapter information retrieved successfully

application/json

401

Unauthorized

application/json

post

/cast-adapter/{roomId}

POST /cast-adapter/{roomId} HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

{
  "connectionString": "text"
}

/livekit-webhook

post

/livekit-webhook

Webhook endpoint for LiveKit events

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Body

objectOptional

LiveKit webhook payload

Responses

200

Webhook processed successfully

No content

post

/livekit-webhook

POST /livekit-webhook HTTP/1.1
Host: worlds-content-server.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

200

Webhook processed successfully

No content

PreviousOverview NextAsset Bundle Registry

Last updated 1 month ago

hashtag/world/{world_name}/about

hashtag/entities

hashtag/entities/{world_name}

hashtag/entities/active

hashtag/available-content

hashtag/ipfs/{hashId}

hashtag/ipfs/{hashId}

hashtag/contents/{hashId}

hashtag/contents/{hashId}

hashtag/world/{world_name}/permissions

hashtag/world/{world_name}/permissions/{permission_name}

hashtag/world/{world_name}/permissions/{permission_name}/{address}

hashtag/world/{world_name}/permissions/{permission_name}/{address}

hashtag/wallet/{wallet}/stats

hashtag/wallet/{wallet}/connected-world

hashtag/wallet/contribute

hashtag/status

hashtag/index

hashtag/live-data

hashtag/get-comms-adapter/{roomId}

hashtag/cast-adapter/{roomId}

hashtag/livekit-webhook

/world/{world_name}/about

/entities

/entities/{world_name}

/entities/active

/available-content

/ipfs/{hashId}

/ipfs/{hashId}

/contents/{hashId}

/contents/{hashId}

/world/{world_name}/permissions

/world/{world_name}/permissions/{permission_name}

/world/{world_name}/permissions/{permission_name}/{address}

/world/{world_name}/permissions/{permission_name}/{address}

/wallet/{wallet}/stats

/wallet/{wallet}/connected-world

/wallet/contribute

/status

/index

/live-data

/get-comms-adapter/{roomId}

/cast-adapter/{roomId}

/livekit-webhook