Skip to main content
POST
Send a WebRTC offer (browser)

Authorizations

X-Webcall-Grant
string
header
required

A web call's single-use grant, from POST /v1/web-call-sessions (created on your server with your API key and allowed_origin). Only the browser's /client operations take it, from that origin only; they need no API key.

Headers

Kallabot-Version
enum<string>

The 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.

Available options:
2026-11-07
Example:

"2026-11-07"

Path Parameters

call_id
string
required

Body

application/json

Small WebRTC transport session arguments for the runner.

Parameters: sdp: The SDP string (Session Description Protocol). type: The type of the SDP, either "offer" or "answer". pc_id: Optional identifier for the peer connection. restart_pc: Optional whether to restart the peer connection. request_data: Optional custom data sent by the customer.

sdp
string
required
type
string
required
pc_id
string | null
restart_pc
boolean | null
request_data
unknown

Response

Successful Response

sdp
string
required

The SDP answer.

type
string
required

Always answer.

pc_id
string | null

The peer connection's id; send it with ICE candidates.