Sign in

v29

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-233765161.7 KB
v1 realtime

Get a LiveKit room token

Generate a LiveKit JWT token for a participant to join a video/audio room.

This endpoint:
- Validates API key authentication
- Creates a token with publish + subscribe grants for the specified room
- Returns a JWT that the frontend uses to connect to the LiveKit server

**Authentication**: Requires valid API key in Authorization header
post/v1/realtime/token

Request body

user_idstring required

The user ID

project_idstring nullable

The project ID

persona_idstring nullable

The persona ID

disabled_learningboolean required

Whether to disable learning

session_idstring required

The session ID

metadataobject nullable

Extra metadata forwarded to the agent (e.g. learn flag)

Response

Successful Response

tokenstring required

JWT token to connect to LiveKit

session_idstring required

The session ID

successboolean

Indicates successful token generation