> ## Documentation Index
> Fetch the complete documentation index at: https://stage-docs.oktivo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Call

> Cancel a pending/in-progress call and any scheduled retries.

## Path Parameters

**contactUID** `string` *required*

The unique identifier of the contact to cancel.

## Response

**success** `boolean`

Indicates if the cancellation was successful.

**message** `string`

Confirmation message.

```json 200 Success theme={null}
{
  "success": true,
  "message": "Call cancelled successfully"
}
```

```json 404 Not Found theme={null}
{
  "success": false,
  "message": "Contact not found"
}
```

```json 409 Conflict theme={null}
{
  "success": false,
  "message": "Cannot cancel contact with status \"completed\""
}
```

## Behavior

* The contact's status is set to `stopped`
* Any scheduled retries are cancelled immediately
* No further credits will be consumed for this contact
* If the call is currently active (ringing or connected), this does **not** hang up the call it only prevents future retry attempts

## Cancellable Statuses

You can only cancel contacts in these statuses:

| Status | Can Cancel? |
| - | - |
| `pending` | ✅ Yes |
| `in_progress` | ✅ Yes |
| `completed` | ❌ No returns `409` |
| `failed` | ❌ No returns `409` |
| `stopped` | ❌ No already cancelled |

> [!NOTE]
>
> This endpoint accepts both **API Token** (`okt_...`) and **JWT** authentication.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.