Sessions

Start a browser WebRTC session

Creates a browser voice session and returns a room URL plus a one-time access token your browser uses to connect to the agent in real time.

The session is fully tracked on the platform — when the session ends, the same session.completed partner webhook fires (transcript, recording_url, extraction). The webhook payload’s call field is omitted for these sessions because there is no associated phone call. See Web Voice Testing for end-to-end browser integration code.

Auth + limits: Bearer API key (rg_live_*). Bound by the API key’s concurrency limit. Rate-limited to 10 starts/minute per key.

POST

sessions

webrtc

Start a browser WebRTC session

curl --request POST \
  --url https://api.vocobase.com/api/v2/sessions/webrtc \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "variables": {
    "callee_name": "Sajal"
  }
}
'

{
  "success": true,
  "data": {
    "session_id": "s1234567-abcd-1234-abcd-123456789012",
    "agent_id": "a1234567-abcd-1234-abcd-123456789012",
    "daily_room_url": "https://voice-session.example.com/abc123",
    "daily_token": "eyJhbGciOi..."
  }
}

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.

Show child attributes

Example:

{ "callee_name": "Sajal" }

Response

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

success

boolean

data

object

Show child attributes

Get a sessionReturns the same fields delivered by the `session.completed` partner webhook (transcript, recording, extraction, variables, agent name, status, duration, credits). Polling fallback for partners that can't accept inbound webhooks. Mints a fresh presigned `recording_url` on every call (valid 7 days). Authorization is by `partner_config_id` — partners can only read sessions started via their own v2 endpoints (`/sessions/webrtc` or `/calls/start`).

Start a browser WebRTC session

curl --request POST \
  --url https://api.vocobase.com/api/v2/sessions/webrtc \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "variables": {
    "callee_name": "Sajal"
  }
}
'

{
  "success": true,
  "data": {
    "session_id": "s1234567-abcd-1234-abcd-123456789012",
    "agent_id": "a1234567-abcd-1234-abcd-123456789012",
    "daily_room_url": "https://voice-session.example.com/abc123",
    "daily_token": "eyJhbGciOi..."
  }
}

Documentation Index

Authorizations

Body

Response