Retire a public key
Immediate — retiring a key narrows access. Refuses to retire the last
usable key of the credential (409 last_public_key), which would leave
it unusable with no way back.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
tenantId
Tenant identifier (same value as X-Tenant-Id).
clientId
Credential (client_id) the subresource belongs to.
kid
Key identifier returned at registration time.
Headers
X-Tenant-Id
Tenant context used for authorization and routing.
Idempotency-Key
Optional client-generated idempotency token (recommended for safe retries).
Response
Key retired.
kid
status
Errors
403
Forbidden Error
404
Not Found Error
409
Conflict Error