Listen to a call the AI assistant is handling (receive-only)

POST 
/api/calls/:callId/listen

The browser's SDP offer (receive-only audio) is answered by a send-only bridge leg that carries the caller and whatever the caller hears (the assistant, notices, hold audio), mixed and encoded as Opus 48 kHz. Nothing travels the other way: the caller and the assistant never hear the listener, and nothing about the call changes.

Only while the assistant holds the call (ai_state attaching / live / escalating, nobody has answered it). Every start is written to the audit log as call.listen_started (who, which call, when); the caller is told nothing beyond the call's existing recording notice.

Request

Responses

200

The bridge's answer; audio flows once ICE connects.

401

Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).

403

Authenticated but not allowed.

404

Resource not found (or not visible to the current tenant).

409

listen_requires_ai (the assistant does not hold the call) or a bridge refusal (call_not_active, listen_exists).

422

The request failed validation.

429

listen_limit — the call already has the most listeners the bridge allows.

501

listen_unsupported — this media bridge has no listen leg.

503

listen_bridge_unavailable — the media bridge could not be reached.