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

# DELETE /v1/api-keys/{id} — Revoke API Key

> Permanently revoke a RelayOS API key by its ID. Revocation is immediate — any request using the deleted key instantly returns 401 Unauthorized.

Use this endpoint to permanently revoke an API key. Revocation takes effect immediately — any request using the deleted key will receive a `401 Unauthorized` response. Use `GET /v1/api-keys` to find the `id` of the key you want to revoke.

<Warning>
  Revoking an API key is irreversible. The key cannot be restored after deletion. Make sure no active services are using the key before revoking it, and have a replacement key ready if needed.
</Warning>

## Request

**`DELETE https://api.relayos.com.br/v1/api-keys/{id}`**

<ParamField path="id" type="string" required>
  The unique identifier of the API key to revoke. Retrieve the `id` from `GET /v1/api-keys`.
</ParamField>

```bash theme={null}
curl -X DELETE https://api.relayos.com.br/v1/api-keys/key_01hwxyz222bbb \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

A successful revocation returns `204 No Content` with an empty response body.