API ReferencePublic

WebRTC signaling for shareable agent links

Submit a WebRTC SDP offer to start a browser-based call with a shareable agent. No authentication required. The agent must have shareable: true. Rate limited to 10 concurrent calls and 50 calls per day per agent.

Path parameters

agent_idstringRequired

Agent ID (must have shareable enabled)

Request

This endpoint expects an object.
sdpstringRequired

WebRTC SDP offer from the browser (RFC 8829)

agent_idstringRequired
Agent ID to route this call to
workspace_idstringRequired

Workspace ID that owns the agent; used for billing enforcement

type"offer"Optional

SDP type — must be “offer”

sourcestringOptional

Call source hint passed through to the call.initiated webhook payload (e.g. “browser_test”, “shareable”)

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
Public TRY Agent Offer Request Bad Request Error
402
Public TRY Agent Offer Request Payment Required Error
404
Public TRY Agent Offer Request Not Found Error
429
Public TRY Agent Offer Request Too Many Requests Error