Private Messages

Get private messages token

get

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

/private-messages/token

Generates a LiveKit token for accessing private messages. This endpoint checks user privacy settings and generates appropriate credentials. Requires Signed Fetch authentication from dcl:explorer. 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

SignedFetchExplorer

x-identitystringRequired

Signed Fetch authentication for Explorer-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 dcl:explorer.

Responses

200

Private messages token generated successfully

application/json

adapterstringRequired

LiveKit connection URL for private messages

401

Unauthorized - Invalid authentication or blacklisted user

application/json

500

Internal server error

application/json

get

/private-messages/token

HTTPcURLJavaScriptPython

GET /private-messages/token HTTP/1.1
Host: comms-gatekeeper.decentraland.org
x-identity: YOUR_API_KEY
Accept: */*

{
  "adapter": "text"
}

Update user private messages privacy

patch

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

/users/{address}/private-messages-privacy

Updates the privacy settings for a user's private messages. This affects who can send private messages to the user. Requires Bearer Token authentication.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication for service-to-service communication.

Path parameters

addressstringRequired

ETH address of the user

Body

application/json

private_messages_privacystring · enumRequired

Privacy setting for private messages

Possible values:

Responses

204

Privacy settings updated successfully

400

Invalid request - Invalid address or privacy setting

application/json

401

Unauthorized - Invalid token

application/json

500

Internal server error

application/json

patch

/users/{address}/private-messages-privacy

HTTPcURLJavaScriptPython

PATCH /users/{address}/private-messages-privacy HTTP/1.1
Host: comms-gatekeeper.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "private_messages_privacy": "all"
}

No content