# Revoke a key

`DELETE /api/api-keys/{id}`  (operationId: `revokeApiKey`, group: API keys)

Ends a key immediately. The row is kept so its audit trail survives.

Part of the full API, which is included in the Scale plan. Workspace admin: a dashboard session, or a full-access key created by an admin. A scoped key is refused with scope_denied.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | integer | yes | Key id. |

**Response 200**: Revoked.

Example:

```json
{
  "success": true
}
```

**Errors specific to this call.** The common ones (401, 403, 429 and the rest) are in the [Errors guide](https://inboxwa.online/docs/api/guide/errors.md).

| Status | error | When |
| --- | --- | --- |
| 404 | `not_found` | No such key. |
| 400 | `already_revoked` | Already revoked. |

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json