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

# Revoke API Key

> Permanently revoke an API key, disabling all further access

## Revoke API Key

```text theme={"dark"}
DELETE /v1/api-keys/:id
```

Revokes an API key, permanently disabling it. Revoked keys cannot be reactivated.

### Path Parameters

| Parameter | Type   | Description                       |
| --------- | ------ | --------------------------------- |
| `id`      | string | The API key ID (UUID or `key_id`) |

### Response

```json theme={"dark"}
{
  "data": { "revoked": true },
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}
```

<Warning>
  You cannot revoke the API key that you are currently using to authenticate the request. Use a different key to revoke it, or revoke it from the dashboard.
</Warning>

### Errors

| Status | Type               | Description                            |
| ------ | ------------------ | -------------------------------------- |
| 400    | `validation_error` | Cannot revoke the key currently in use |
| 404    | `not_found`        | API key not found                      |