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

# Cancel Call

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

## Request

- Base URL: `https://api.cartesia.ai`
- URL: `https://api.cartesia.ai/agents/calls/{call_id}/cancel`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cartesia/apis/cartesia-api/docs/agents/calls/:call_id/cancel/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/cartesia/apis/cartesia-api.md) - [All operations](https://skmtc.dev/cartesia/apis/cartesia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cartesia/apis/cartesia-api/revisions/8910812440d3?raw)