Revoke API key

DELETE https://app.speybooks.com/api/v1/api-keys/{id}

Permanently revoke an API key. The key stops authenticating immediately. This action cannot be undone — create a new key if access is needed again. Already-revoked keys return a 409 Conflict.

Path parameters

id integer required

API key ID to revoke.

Response

200 API key revoked. All requests using this key will now fail immediately.

Show response fields

id integer

message string

revokedAt string date-time

Error codes

404 API key not found.

409 API key is already revoked.

Request DELETE /v1/api-keys/{id} curl

curl -X DELETE https://api.speybooks.com/v1/api-keys/7 \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "id": 7,
    "revokedAt": "2026-02-19T12:00:00.000Z",
    "message": "API key revoked. Any requests using this key will now fail."
  }
}