Overview

The Comms Gatekeeper API is a comprehensive service that manages communications, voice chats, scene administration, and streaming access for the Decentraland metaverse. It provides the infrastructure for real-time voice communication, scene management, user moderation, and content streaming capabilities.

Core Features

Scene Management

• Scene adapter connection for LiveKit voice chat rooms

• Scene administration (add/remove admins)

• Scene banning system for user moderation

Streaming Access

• Live streaming key management for scene content creators

• RTMP streaming URL and key generation

• Streaming access lifecycle management

Voice Communication

• Private voice chat sessions between users

• Community voice chat with speaker management

• Request-to-speak functionality for moderated discussions

• Real-time participant management

User Management

• Private messages token generation

• Privacy settings management

• User ban management per scene

• Scene access control

Platform Moderation

• Platform-level (global) user bans enforced at token issuance time

• Timed or permanent bans with optional custom player-facing messages

• Moderator-only ban listing and lift operations

• User warnings system for graduated enforcement

• World-scoped ban status check for service-to-service use

Authentication

The API supports three authentication methods:

• Signed Fetch (Scene): Used for scene-based requests from decentraland-kernel-scene

• Signed Fetch (Explorer): Used for explorer-based requests from dcl:explorer

• Bearer Token: Used for service-to-service communication

Most endpoints require Signed Fetch authentication with a complete identity header chain including scene metadata (sceneId, parcel, realmName).

Base URLs

• Production: https://comms-gatekeeper.decentraland.org

• Development: https://comms-gatekeeper.decentraland.zone