Submit a WebRTC SDP offer for an authenticated browser call | Voicebip

Submits a browser’s WebRTC SDP offer to start a call with an agent your workspace owns, and returns the SDP answer. Accepts a full-scope API key, a dashboard session JWT, or a scoped token from POST /v1/webrtc/token (in which case the body’s agent_id must match the token’s webrtc_agent_id claim). For public/shareable agents with no auth, use POST /v1/public/try/{agent_id}/offer instead.

Submits a browser's WebRTC SDP offer to start a call with an agent your workspace owns, and returns the SDP answer. Accepts a full-scope API key, a dashboard session JWT, or a scoped token from `POST /v1/webrtc/token` (in which case the body's `agent_id` must match the token's `webrtc_agent_id` claim). For public/shareable agents with no auth, use `POST /v1/public/try/{agent_id}/offer` instead.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

agent_idstringRequired

sdpstringRequired

WebRTC SDP offer from the browser (RFC 8829)

type"offer"Optional

Response

WebRTC SDP answer

sdpstring

WebRTC SDP answer from the server (RFC 8829)

type"answer"

SDP type — always “answer”

call_idstring

Call ID for tracking this browser call; use in call.* webhook events

Errors

400

Create Web Rtc Offer Request Bad Request Error

402

Create Web Rtc Offer Request Payment Required Error

403

Create Web Rtc Offer Request Forbidden Error

404

Create Web Rtc Offer Request Not Found Error

$	curl -X POST https://api.voicebip.com/v1/webrtc/offer \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"agent_id": "agt_WX1Y_abcdef123456",
>	"sdp": "sdp"
>	}'