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

# Pause a batch call

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

Suspends dialing. Recipients that have not been dialed stay queued, so resuming continues where the batch left off. Calls already in progress are not affected. A batch can be paused while it is `scheduled` or `in_progress`.

## Path parameters

- `batch_call_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

200

- BatchCallsPauseABatchCallResponse200
  - `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

- `400` — The batch is completed, canceled or already paused.
- `401` — Missing or invalid API key.
- `404` — No batch with that id exists in the workspace.

---

[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)