Cast 2.0

Get streamer token

post

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

/cast/streamer-token

Generates LiveKit credentials for a streamer to broadcast in a scene. This endpoint validates a streaming token and provides the necessary credentials for a streamer to connect to the LiveKit room and start streaming. No authentication required - uses streaming token for validation.

Body

application/json

tokenstringRequired

Streaming token for authentication

identitystringRequired

Display name for the streamer

Responses

200

Streamer token generated successfully

application/json

400

Invalid request - Missing required fields

application/json

401

Unauthorized - Invalid or expired streaming token

application/json

500

Internal server error

application/json

post

/cast/streamer-token

HTTPcURLJavaScriptPython

POST /cast/streamer-token HTTP/1.1
Host: comms-gatekeeper.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "token": "text",
  "identity": "text"
}

{
  "url": "text",
  "token": "text",
  "roomId": "text",
  "identity": "text"
}

Get watcher token

post

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

/cast/watcher-token

Generates LiveKit credentials for a watcher to view streams in a location. This endpoint allows users to join as viewers in a specific location (parcel or world) and watch active streams. No authentication required.

Body

application/json

locationstringRequired

Location (parcel coordinates or world name)

Example: 20,-4

identitystringRequired

Display name for the watcher

Responses

200

Watcher token generated successfully

application/json

400

Invalid request - Missing required fields

application/json

401

Unauthorized - No active stream found for location

application/json

500

Internal server error

application/json

post

/cast/watcher-token

HTTPcURLJavaScriptPython

POST /cast/watcher-token HTTP/1.1
Host: comms-gatekeeper.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "location": "20,-4",
  "identity": "text"
}

{
  "url": "text",
  "token": "text",
  "roomId": "text",
  "identity": "text",
  "placeName": "text"
}

Generate stream link

get

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

/cast/generate-stream-link

Generates a unique stream link for a scene that allows streamers to broadcast and watchers to view the stream. Only scene administrators can generate stream links. The generated link expires after 4 days. 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.

Responses

200

Stream link generated successfully

application/json

400

Invalid request - Missing required fields or invalid scene data

application/json

401

Unauthorized - Authentication required or insufficient permissions

application/json

500

Internal server error

application/json

get

/cast/generate-stream-link

HTTPcURLJavaScriptPython

GET /cast/generate-stream-link HTTP/1.1
Host: comms-gatekeeper.decentraland.org
x-identity: YOUR_API_KEY
Accept: */*

{
  "streamLink": "text",
  "watcherLink": "text",
  "streamingKey": "text",
  "placeId": "text",
  "placeName": "text",
  "expiresAt": "2026-01-20T18:17:16.821Z",
  "expiresInDays": 1
}

Get stream information

get

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

/cast/stream-info/{streamingKey}

Retrieves information about a stream using its streaming key. This endpoint provides details about the place, location, and stream status. No authentication required.

Path parameters

streamingKeystringRequired

Streaming key for the stream

Responses

200

Stream information retrieved successfully

application/json

400

Invalid request - Invalid streaming key

application/json

404

Stream not found or expired

application/json

500

Internal server error

application/json

get

/cast/stream-info/{streamingKey}

HTTPcURLJavaScriptPython

GET /cast/stream-info/{streamingKey} HTTP/1.1
Host: comms-gatekeeper.decentraland.org
Accept: */*

{
  "placeName": "text",
  "placeId": "text",
  "location": "text",
  "isWorld": true
}