Private Voice Chat

Get user voice chat status

get

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

/users/{address}/voice-chat-status

Checks if a user is currently in a voice chat. Requires Bearer Token authentication.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication for service-to-service communication.

Path parameters

addressstringRequired

ETH address of the user

Responses

200

Voice chat status retrieved successfully

application/json

is_user_in_voice_chatbooleanRequired

Whether the user is currently in a voice chat

400

Invalid request - Invalid address

application/json

401

Unauthorized - Invalid token

application/json

500

Internal server error

application/json

get/users/{address}/voice-chat-status

HTTPcURLJavaScriptPython

GET /users/{address}/voice-chat-status HTTP/1.1
Host: comms-gatekeeper.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "is_user_in_voice_chat": true
}

Create private voice chat

post

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

/private-voice-chat

Creates a private voice chat room for two users. Generates LiveKit credentials for both users to join the room. Requires Bearer Token authentication.

Rejected with 403 when either participant has an active platform ban. The whole call is refused rather than issuing credentials only to the unbanned party, who would otherwise wait alone in a room nobody can join.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication for service-to-service communication.

Body

application/json

user_addressesstring[] · min: 2 · max: 2Required

Array of exactly 2 ETH addresses for the private voice chat

room_idstringRequired

Unique identifier for the voice chat room

Responses

200

Private voice chat created successfully

application/json

Object with user addresses as keys and connection URLs as values

400

Invalid request - Invalid addresses or room ID

application/json

401

Unauthorized - Invalid token

application/json

403

Forbidden - One of the participants has an active platform ban, or last connected from a banned device

application/json

500

Internal server error

application/json

post/private-voice-chat

HTTPcURLJavaScriptPython

POST /private-voice-chat HTTP/1.1
Host: comms-gatekeeper.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "user_addresses": [
    "text"
  ],
  "room_id": "text"
}

{
  "ANY_ADDITIONAL_PROPERTY": {
    "connection_url": "text"
  }
}

Delete private voice chat

delete

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

/private-voice-chat/{id}

Ends a private voice chat room. This will disconnect all participants from the room. Requires Bearer Token authentication.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication for service-to-service communication.

Path parameters

idstringRequired

Room ID of the private voice chat

Responses

204

Private voice chat ended successfully

No content

401

Unauthorized - Invalid token

application/json

404

Private voice chat not found

application/json

500

Internal server error

application/json

delete/private-voice-chat/{id}

HTTPcURLJavaScriptPython

DELETE /private-voice-chat/{id} HTTP/1.1
Host: comms-gatekeeper.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content