Scene Administration

List scene administrators

get

https://comms-gatekeeper.decentraland.orghttps://comms-gatekeeper.decentraland.zone

/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

SignedFetch

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

400

Invalid request parameters

application/json

401

Unauthorized - Authentication required or insufficient permissions

application/json

500

Internal server error

application/json

get

/scene-admin

HTTPcURLJavaScriptPython

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

https://comms-gatekeeper.decentraland.orghttps://comms-gatekeeper.decentraland.zone

/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

SignedFetch

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

application/json

adminstringOptional

ETH address of the admin to add

namestringOptional

Decentraland name of the admin to add

Responses

204

Scene administrator added successfully

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

HTTPcURLJavaScriptPython

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

https://comms-gatekeeper.decentraland.orghttps://comms-gatekeeper.decentraland.zone

/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

SignedFetch

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

application/json

adminstringOptional

ETH address of the admin to add

Responses

204

Scene administrator removed successfully

400

Invalid request

application/json

401

Unauthorized - Authentication required or insufficient permissions

application/json

500

Internal server error

application/json

delete

/scene-admin

HTTPcURLJavaScriptPython

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