---
title: "Cancel a call"
method: DELETE
path: "/api/v1/outbound/calls/{callId}"
tags: ["Outbound Calls"]
---

# Cancel a call

`DELETE /api/v1/outbound/calls/{callId}`

## Request

- Base URL: `https://api.callnode.io`
- URL: `https://api.callnode.io/api/v1/outbound/calls/{callId}`
- Auth: API key in header `X-Api-Key` and API key in header `X-Timestamp` and API key in header `X-Signature`

Hangs up an in-progress call, or cancels one that has not yet connected.
Calls already in a terminal state are returned unchanged (also 202) — the
operation is safe to retry.

## Response `202`

Cancellation accepted, or the call was already terminal.

- object
  - `callId` string
  - `status` 'originating' | 'ringing' | 'answered' | 'completed' | 'failed' | 'canceled'

## Other responses

- `401`: Missing, unknown, or badly signed credentials — check the HMAC and the timestamp skew.
- `404`: No such resource on this account.

---

[API](https://skmtc.dev/callnode/apis/callnode-outbound-api.md) · [All operations](https://skmtc.dev/callnode/apis/callnode-outbound-api/llms.txt) · [OpenAPI document](https://skmtc.dev/callnode/apis/callnode-outbound-api/revisions/c7da6ad06509?raw)