API referenceAPI keys
Revoke a key
DELETE
/api-keys/{id}Soft-revoke: the row is kept with status revoked and stops authenticating immediately. A key cannot revoke itself — that returns 400.
Requires an API key with one of these roles: admin.
Authorization
bearerAuth AuthorizationBearer <token>
An API key created in Settings → API Keys.
In: header
Path Parameters
id*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api-keys/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "revoked" }, "meta": { "requestId": "string", "timestamp": "string" }}