Scene Bans

List scene bans

get

/scene-bans

Lists all banned users for a specific scene or world. Only scene owners or 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

limitinteger · min: 1 · max: 100Optional

Number of bans per page

Default: 20

offsetintegerOptional

Number of bans to skip

Default: 0

Responses

200

Scene bans retrieved successfully

application/json

totalintegerRequired

Total number of bans

pageintegerRequired

Current page number

pagesintegerRequired

Total number of pages

limitintegerRequired

Number of items per page

400

Invalid request parameters

application/json

401

Unauthorized - Authentication required

application/json

500

Internal server error

application/json

get/scene-bans

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

{
  "results": [
    {
      "bannedAddress": "text",
      "name": "text"
    }
  ],
  "total": 1,
  "page": 1,
  "pages": 1,
  "limit": 1
}

Add scene ban

post

/scene-bans

Bans a user from a specific scene or world. Only scene owners or administrators can ban users. 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

banned_addressstringOptional

ETH address of the user to ban

banned_namestringOptional

Name of the user to ban

Responses

204

User banned successfully

No content

400

Invalid request - Invalid address or missing required fields

application/json

401

Unauthorized - Authentication required

application/json

500

Internal server error

application/json

post/scene-bans

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

{
  "banned_address": "text",
  "banned_name": "text"
}

No content

Remove scene ban

delete

/scene-bans

Removes a ban from a user for a specific scene or world. Only scene owners or administrators can remove bans. 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

banned_addressstringOptional

ETH address of the user to ban

banned_namestringOptional

Name of the user to ban

Responses

204

Ban removed successfully

No content

400

Invalid request

application/json

401

Unauthorized - Authentication required

application/json

500

Internal server error

application/json

delete/scene-bans

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

{
  "banned_address": "text",
  "banned_name": "text"
}

No content

List banned addresses

get

/scene-bans/addresses

Lists all banned addresses for a specific scene or world. Only scene owners or 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.

Responses

200

Banned addresses retrieved successfully

application/json

bannedAddressesstring[]Required

Array of banned ETH addresses

401

Unauthorized - Authentication required

application/json

500

Internal server error

application/json

get/scene-bans/addresses

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

{
  "bannedAddresses": [
    "text"
  ]
}