Skip to main content
POST
Start a browser WebRTC session

Authorizations

Authorization
string
header
required

API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.

Body

application/json
agent_id
string<uuid>
required

ID of the agent to use for this session.

variables
object

Pre-call variable values. Keys must match variable names declared on the agent (Agent.variables). Substituted into the agent's prompt and greeting via {{name}} placeholders. Echoed in the session.completed webhook for partner-side audit. Missing variables render as empty strings.

Example:

Response

Session started successfully. Pass daily_room_url and daily_token to your WebRTC client.

success
boolean
data
object