Skip to main content
POST
Create a realtime session

Authorizations

Authorization
string
header
required

A long-lived, privileged API key (ek_... prefix), minted once from the dashboard. Intended for trusted server-side use only; never expose it in client-side code. Send as Authorization: Bearer ek_.... Required by every Calls, Batches, Agents, Tools, MCP Servers, Documents, and Realtime route.

Body

application/json
agent_id
string
required
user_id
string
required
source
enum<string>
default:audio
Available options:
audio,
text,
camera,
screen
variables
Variables · object

Response

Successful Response

session_token
string
required
expires_at
string
required
ws_url
string
required