Live Call Control
Your app can drive a call that is already up: put it on hold, mute it, send keypresses, park it, or hang it up. This is what a CRM’s “Hold” button or an agent desktop’s “End call” button calls under the hood.
curl -X POST 'https://api.sip.io/v1/calls/mine/control' \ -H 'x-api-key: sk_…' -H 'content-type: application/json' \ -d '{ "action": "hold" }'action | Effect |
|---|---|
hold · unhold | Hold the far end (they hear hold music) and take it back. |
mute · unmute | Stop and restart sending your audio. |
dtmf | Send keypresses into the call, with digits (for an IVR on the far end). |
park | Park the call so someone else can pick it up. |
hangup | End the call. |
Which call
Section titled “Which call”mineis the call the credential’s own user is on, which is all a softphone or agent app needs.- With the
calls:allscope an admin or supervisor app can control any live call in the account, named by its SIP Call-ID or its media-edge channel id (as the live board reports it). - A session token is always limited to its own user’s calls.
Errors
Section titled “Errors”| Status | error | Meaning |
|---|---|---|
403 | not_your_call | Without calls:all, the call must be yours. |
404 | no_active_call · call_not_found · call_ended | There is no live call by that id. |
409 | call_control_refused | The media edge refused the action: the call has just ended, or is not anchored on it. |
502 | node_error · no_node | The node carrying the call could not be reached. |
Related
Section titled “Related”- Call Transfer:
POST /v1/calls/{id}/transfer. - Supervision: listen, whisper and barge.
- Call Recording: pause and resume recording mid-call.
© 2026 SIP.IO