Get, list & cancel
Read status and outcomes, list recent tasks, and cancel before anyone dials.
Get a task
get_call_task({ task_id }) · GET /api/tasks/{id}. Returns the task, including outcome once completed.
List tasks
list_call_tasks({ status?, limit? }) · GET /api/tasks?status=completed. Newest first, up to 200 over MCP and 50 over REST.
Cancel a task
cancel_call_task({ task_id }) · POST /api/tasks/{id}/cancel. Works for review, open and claimed tasks. A caller holding the task can't dial it after cancellation. Returns 409 if the task is already completed, cancelled or expired.
Statuses
| Status | Meaning |
|---|---|
review | Saved; waiting for a plan (free calls used up). Dispatches automatically once a plan is active. |
open | Waiting for a caller. |
claimed | A caller has it and may be dialing. |
completed | Outcome logged. |
cancelled | Cancelled by you, an admin, or a do-not-call entry. |
expired | Not claimed before deadline_minutes. |