Skip to main content
DELETE

Authentication

Requires an API key in the Authorization header.

Request

string
required
The key’s database id, as returned by List API keys. Not the key_prefix.
string
Set to the exact string true to permanently delete the key instead of revoking it. Any other value revokes.

Revoke (soft disable)

Delete (permanent removal)

Response

Or for permanent deletion:
Known issue: A revoked key can be enabled again with PATCH ?action=enable and revealed with GET /api/account/keys/reveal. Revoked and disabled keys both appear as is_active: false. Permanently delete a leaked key.

Permissions

readonly members get 403. A tech member can only revoke their own keys; only a workspace admin can revoke another member’s key. A key that is out of your scope returns 404, the same as an unknown id.

Errors

Errors return the shared envelope with success, result.code, message, and request_id. A legacy error key is included alongside it.