Revoke API key
Revokes one API key from the authenticated workspace. Subsequent requests using the revoked key fail with 401. Revoking a key cannot be undone — generate a new one if you need to restore access.
Authorization
AuthorizationBearer <token>In header
Workspace API key, or a Clerk session JWT for dashboard callers. A key can revoke itself; the next request authenticated with that key will fail.
Path Params
key_idstring
API key record ID to revoke.
Response Body
204
status204 No Content
Revoked successfully; no response body.
401
error.codestring
Usually "UNAUTHORIZED", "NOT_FOUND", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
404
error.codestring
Usually "UNAUTHORIZED", "NOT_FOUND", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED", "NOT_FOUND", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.