Revoke API key

DELETEhttps://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

idintegerrequired

API key ID to revoke.

Response

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

Show response fields

idinteger

messagestring

revokedAtstringdate-time

Error codes

404API key not found.

409API key is already revoked.

RequestDELETE/v1/api-keys/{id}curl

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

Response200

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