Skip to navigation

Revoke all of a principal's keys

API key required. One click to kill every live key of the principal — contractor offboarding, incident response. Each revoked key gets its own REVOKE receipt carrying the given reason, so every key stays individually visible in the audit log. The principal itself is untouched.

Path parameters

principalIdstringRequired

Request

This endpoint expects an object.
reasonstringOptional

Why the keys are being revoked; written into each REVOKE receipt.

Response

The revoked key ids.

Errors

401
Unauthorized Error
404
Not Found Error