---
title: "Cancel a batch call"
method: POST
path: "/calls/batch/{batch_call_id}/cancel"
tags: ["batchCalls"]
---

# Cancel a batch call

`POST /calls/batch/{batch_call_id}/cancel`

Permanently stops the batch. Recipients that have not been dialed are marked canceled and will never be called. Calls already in progress are not hung up. A canceled batch cannot be resumed and cannot take new recipients.

## Path parameters

- `batch_call_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

200

- BatchCallsCancelABatchCallResponse200
  - `status` string
  - `response` BatchCallStatus
    - `batch_call_id` string
    - `name` string
    - `status` string — One of `scheduled`, `in_progress`, `paused`, `completed` or `canceled`.
    - `total_task_count` integer — Recipients stored in the batch.
    - `dispatched_count` integer — Recipients whose call was placed.
    - `failed_count` integer — Recipients whose call could not be placed.
    - `pending_count` integer — Recipients still waiting to be dialed.
    - `created_at` string
    - `model_id` string — The agent placing the calls.
    - `agent_name` string
    - `from_phone_number` string

## Other responses

- `401` — Missing or invalid API key.
- `404` — No batch with that id exists in the workspace.

## Changes

- **2026-08-19** `636788eb0d70` — 2 breaking, 2 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - the response's body type/format changed from ``/`` to `object`/`` for status `404`
  - added the optional property `detail` to the response with the `401` status
  - added the optional property `detail` to the response with the `404` status
- **2026-08-17** `f04f8c465268` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/synthflow/apis/platform-api/changes/calls/batch/:batch_call_id/cancel/post.md)

---

[API](https://skmtc.dev/synthflow/apis/platform-api.md) · [All operations](https://skmtc.dev/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/synthflow/platform-api/revisions/6976456ad422/schema)