Listen in or take over
Joins a live call as you. mode: listen (hear it silently), takeover (speak to the caller from the browser while the agent goes quiet) or phone_takeover (we ring your phone, in E.164, and the agent goes quiet when you answer). listen and takeover return monitor.path: a WebSocket to open within expires_in seconds. Returns 409 when the call isn’t live, someone else already holds it, or a phone takeover isn’t possible for this call. Needs call:content.
Needs a personal key (kbp_live_…): it acts as you.
Scopes: call:read, call:control
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.
255The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"