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

tenantIdstringRequired

Tenant identifier (same value as X-Tenant-Id).

clientIdstringRequired

Credential (client_id) the subresource belongs to.

kidstringRequired
Key identifier returned at registration time.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

Response

Key retired.
kidstringOptional
statusstringOptional

Errors

403
Forbidden Error
404
Not Found Error
409
Conflict Error