---
title: "Cancel Batch Contact"
api: "DELETE /v1/api/batch-calls/{batchId}/contacts/{phone}"
description: "Cancel the batch job for one phone number."
lastUpdated: "2026-10-29"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

### Headers

<ParamField header="x-workspace-id" type="string" required>
  Workspace identifier for the API.
</ParamField>

### Path Parameters

<ParamField path="batchId" type="string" required>
  The batch that contains the contact.
</ParamField>

<ParamField path="phone" type="string" required>
  Phone number of the contact to cancel, in the E.164 form stored on the batch (for example `+14155550123`). URL-encode it.
</ParamField>

### Behavior and Response

The contact is resolved to its current job (including a pending smart-callback retry), and then handled exactly like [Cancel Batch Job](https://trillet-ai.jamdesk.app/v1/api-reference/endpoints/calls/batch/cancel-job): same response fields (`ok`, `reason`, `message`, `jobId`, `phone`, `callStatus`) and the same status codes:

| HTTP status | `reason` |
|---|---|
| `200` | `cancelled` (removed from the queue, or retries cancelled after the call already finished), `call_in_progress` (the live call continues; future retries are cancelled) |
| `404` | `call_not_found` (no such number in this batch), or `{"error": "Batch not found"}` |
| `409` | `already_cancelled` |
| `500` | `{"ok": false, "error": "..."}` |

### Example

```bash
curl -X DELETE "https://api.trillet.ai/v1/api/batch-calls/k3j9x0a1bq/contacts/%2B14155550123" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-workspace-id: YOUR_WORKSPACE_ID"
```

URL-encode the phone number. A leading `+` is `%2B`.


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
