Revoke current personal API key

View as Markdown
Revokes the stored personal key and returns provider metadata so the CLI can confirm remote revocation before removing local bytes.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

Response

OK
createdAtdatetime
Provider creation timestamp
idstringformat: "^ak_[0-9A-Fa-f]{32}$"

Clerk API-key identifier

namestring

User-visible key name

scopeslist of strings
Clerk scopes assigned to this key
statusenum

Provider-derived current lifecycle state

subjectstring
Owning Clerk user subject
updatedAtdatetime
Provider metadata update timestamp
descriptionstring or nullOptional

Optional user-visible key description

expiresAtdatetime or nullOptional
Provider expiry timestamp
lastUsedAtdatetime or nullOptional

Most recent provider-recorded use timestamp

revocationReasonstring or nullOptional
Provider revocation explanation

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error