Skip to content

Revoke API key

DELETE
/keys/{key_id}

Revoked keys immediately cease to function. Tokens previously issued for this key are rejected. This operation is irreversible. Required role: any.

key_id
required
string format: uuid

API key ID

Revoked

API key metadata (excludes the actual key value).

object
api_key_id
required

Unique key identifier.

string format: uuid
created_at
required

When the key was created.

string format: date-time
expires_at

When the key expires (if set).

string | null format: date-time
name
required

Human-readable name.

string
revoked_at

When the key was revoked (if revoked).

string | null format: date-time
role
required

Role assigned to this key.

string

Unauthorized

Not found

Already revoked

Server error