Calls

Mark an inbound conference call as answered

POST
/api/calls/sdk/answer

Updates an existing inbound Call to status in-progress when the user picks up. Looks up the record by callId, Twilio call SID, or a fuzzy fallback on caller number within the last 5 minutes. Emits call_answered to the call owner and answering user only, plus an org-wide call_activity refresh event (contactId/conversationId only) when the call has a contact. Returns success even when no record is found (best-effort).

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

At least one identifier (callId, twilioCallSid, or callerNumber) should be supplied so the server can locate the Call record.

At least one identifier (callId, twilioCallSid, or callerNumber) should be supplied so the server can locate the Call record.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/calls/sdk/answer" \  -H "Content-Type: application/json" \  -d '{    "callId": "64f0a1b2c3d4e5f6a7b8cb00",    "callerNumber": "+14165550199"  }'
{  "success": true,  "call": {    "_id": "64f0a1b2c3d4e5f6a7b8cb00",    "callId": "64f0a1b2c3d4e5f6a7b8cb00",    "provider": "sinch",    "direction": "outbound",    "status": "initiated",    "from": "+14165550100",    "to": "+14165550199"  },  "message": "Call recorded"}