# DELETE /api/v1/keys/:id

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/keys-revoke

## Summary

Revoke a key by setting revoked_at. The key fails the next request with 401 api_key_revoked, including when you revoke the key you are using. An expired key returns 401 api_key_expired.

## Request

This call has no JSON body.

## Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

## Errors

- HTTP 401 api_key_revoked
- HTTP 401 api_key_expired

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "api_key_revoked",
    "docs_url": "https://cooperemail.com/docs#api_key_revoked"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.