curl -X DELETE "https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/outbound-calls/4c0e7f7e-5d3b-4c8e-9a1f-2b3c4d5e6f70" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "id": "4c0e7f7e-5d3b-4c8e-9a1f-2b3c4d5e6f70", "status": "cancelled" }
{
"error": "conflict",
"error_description": "Call is still in flight and cannot be removed yet"
}
Outbound Calls
Cancel or Delete an Outbound Call
Cancel a scheduled retry so it never dials, or remove a finished call from your records
DELETE
/
v1
/
agents
/
{agentId}
/
outbound-calls
/
{callId}
curl -X DELETE "https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/outbound-calls/4c0e7f7e-5d3b-4c8e-9a1f-2b3c4d5e6f70" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "id": "4c0e7f7e-5d3b-4c8e-9a1f-2b3c4d5e6f70", "status": "cancelled" }
{
"error": "conflict",
"error_description": "Call is still in flight and cannot be removed yet"
}
What this does depends on the call’s status:
scheduled— the retry is cancelled and never dials (cancel_reason: manual). A retry that has already been picked up for dialling is left untouched.- Any finished status — the call is soft-deleted: it stops appearing in the outbound-call and call-log endpoints and its recording and share link stop resolving. Usage and billing figures are unchanged.
- In flight (
queued,dispatching,dispatched,dialing,in_progress) — refused with409; wait for the call to finish.
Path Parameters
string
required
The agent that placed the call
string
required
The outbound call ID
curl -X DELETE "https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/outbound-calls/4c0e7f7e-5d3b-4c8e-9a1f-2b3c4d5e6f70" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "id": "4c0e7f7e-5d3b-4c8e-9a1f-2b3c4d5e6f70", "status": "cancelled" }
{
"error": "conflict",
"error_description": "Call is still in flight and cannot be removed yet"
}
| Code | Meaning |
|---|---|
200 | Scheduled retry cancelled, or finished call deleted |
404 | Agent or call not found, or not accessible to this token |
409 | The call is in flight, or the retry is no longer scheduled |
