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

# Revoke API key

> Revoke a DB-backed API key by ID, permanently disabling it.

Revokes an API key so it can no longer authenticate requests. Revocation is immediate and irreversible (revoked keys are eventually cleaned up by the background cleanup job).

Requires the **master key**. DB-backed auth must be enabled.

<ParamField path="id" type="string" required>
  UUID of the API key to revoke.
</ParamField>

<ResponseField name="ok" type="boolean">
  `true` when the key was successfully revoked.
</ResponseField>

<ResponseField name="id" type="string">
  The ID of the revoked key.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X DELETE http://localhost:3000/auth/keys/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
    -H "Authorization: Bearer $ISOL8_MASTER_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "ok": true,
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
  ```
</ResponseExample>

<Note>
  Returns `404` if no key with the given ID exists.
</Note>