Calls

Accept an incoming call

Accepts a ringing **inbound** call for the authenticated device and brings up the media path. Provide the call_id from the `call.offer` webhook. Answering with live audio also requires opening the WSS media socket.

POST
/calls/accept

Accepts a ringing inbound call for the authenticated device and brings up the media path. Provide the call_id from the call.offer webhook. Answering with live audio also requires opening the WSS media socket.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/calls/accept" \  -H "Content-Type: application/json" \  -d '{    "call_id": "3EB0A1B2C3D4E5F60718"  }'
{  "success": true,  "call_id": "3EB0A1B2C3D4E5F60718",  "status": "connected",  "timestamp": "2026-07-16T18:19:47Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}