---
title: "Cancel Call"
method: POST
path: "/agents/calls/{call_id}/cancel"
tags: ["Agents"]
---

# Cancel Call

`POST /agents/calls/{call_id}/cancel`

Terminates an active call. Only calls in the `started` status can be cancelled; the call ends with end reason `api_cancelled`.

Cancelling ends the call but does not delete its data. To delete a call's sensitive data after it ends, use `DELETE /agents/calls/{call_id}`.

## Path parameters

- `call_id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

The call was cancelled.

- object
  - `cancelled` boolean, required — Always `true` when the cancel is confirmed.

## Other responses

- `400` — The call is not currently active and cannot be cancelled.
- `404` — Call not found, or no active connection was found for the call.
- `502` — The cancel request could not be delivered. Retry the request.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/revisions/8910812440d3/schema)