Scene Administration

List scene administrators

get

/scene-admin

Lists all administrators for a specific scene or world. Only scene owners or existing administrators can access this endpoint. Requires Signed Fetch authentication from decentraland-kernel-scene. Must include the complete identity header chain: x-identity-auth-chain-0, x-identity-auth-chain-1, x-identity-auth-chain-2, x-identity-timestamp, and x-identity-metadata.

Authorizations

x-identitystringRequired

Signed Fetch authentication for scene-based requests. Requires a chain of identity headers:

• x-identity-auth-chain-0: Signer information
• x-identity-auth-chain-1: Ephemeral key information
• x-identity-auth-chain-2: Signed entity information
• x-identity-timestamp: Request timestamp
• x-identity-metadata: Request metadata Used for authentication from decentraland-kernel-scene.

Query parameters

adminstringOptional

Filter by specific admin address

Responses

200

Scene administrators retrieved successfully

application/json

adminstringRequired

ETH address of the admin

namestringRequired

Display name of the admin

canBeRemovedbooleanRequired

Whether this admin can be removed (false for land lease owners)

400

Invalid request parameters

application/json

401

Unauthorized - Authentication required or insufficient permissions

application/json

500

Internal server error

application/json

get/scene-admin

GET /scene-admin HTTP/1.1
Host: comms-gatekeeper.decentraland.org
x-identity: YOUR_API_KEY
Accept: */*

[
  {
    "admin": "text",
    "name": "text",
    "canBeRemoved": true
  }
]

Add scene administrator

post

/scene-admin

Adds a new administrator to a scene or world. Only scene owners or existing administrators can add new administrators. Requires Signed Fetch authentication from decentraland-kernel-scene. Must include the complete identity header chain: x-identity-auth-chain-0, x-identity-auth-chain-1, x-identity-auth-chain-2, x-identity-timestamp, and x-identity-metadata.

Authorizations

x-identitystringRequired

Signed Fetch authentication for scene-based requests. Requires a chain of identity headers:

• x-identity-auth-chain-0: Signer information
• x-identity-auth-chain-1: Ephemeral key information
• x-identity-auth-chain-2: Signed entity information
• x-identity-timestamp: Request timestamp
• x-identity-metadata: Request metadata Used for authentication from decentraland-kernel-scene.

Body

adminstringOptional

ETH address of the admin to add

namestringOptional

Decentraland name of the admin to add

Responses

204

Scene administrator added successfully

No content

400

Invalid request - Invalid admin address or user already has permissions

application/json

401

Unauthorized - Authentication required or insufficient permissions

application/json

500

Internal server error

application/json

post/scene-admin

POST /scene-admin HTTP/1.1
Host: comms-gatekeeper.decentraland.org
x-identity: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "admin": "text",
  "name": "text"
}

No content

Remove scene administrator

delete

/scene-admin

Removes an administrator from a scene or world. Only scene owners or existing administrators can remove administrators. Requires Signed Fetch authentication from decentraland-kernel-scene. Must include the complete identity header chain: x-identity-auth-chain-0, x-identity-auth-chain-1, x-identity-auth-chain-2, x-identity-timestamp, and x-identity-metadata.

Authorizations

x-identitystringRequired

Signed Fetch authentication for scene-based requests. Requires a chain of identity headers:

• x-identity-auth-chain-0: Signer information
• x-identity-auth-chain-1: Ephemeral key information
• x-identity-auth-chain-2: Signed entity information
• x-identity-timestamp: Request timestamp
• x-identity-metadata: Request metadata Used for authentication from decentraland-kernel-scene.

Body

adminstringOptional

ETH address of the admin to add

Responses

204

Scene administrator removed successfully

No content

400

Invalid request

application/json

401

Unauthorized - Authentication required or insufficient permissions

application/json

500

Internal server error

application/json

delete/scene-admin

DELETE /scene-admin HTTP/1.1
Host: comms-gatekeeper.decentraland.org
x-identity: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "admin": "text"
}

No content