Revoke a signer's credential

Revoke the credential of a signer that authenticates with its own key, at once: the signer's current access tokens are refused on their next use and its open signing streams are closed. The signer ends in status credential_revoked and comes back only by enrolling a new key. With access control off, any member of the signer's organisation can revoke it; when access control is enforced, only with the signer device manage permission. Signer principals are refused with 403 SIGNER_PRINCIPAL_NOT_ALLOWED, and machine clients with 403 MACHINE_NOT_ALLOWED. Idempotent: revoking again succeeds. Returns 409 SIGNER_HAS_NO_CREDENTIAL for a signer with no credential to revoke, and 503 CREDENTIAL_STATUS_NOT_PROPAGATED when the credential is revoked but its current token may be accepted for about 30 seconds more, or its open MQTT sessions may not have been ended; retry to confirm.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length between 1 and 255
^\S+$

Signer ID or external ID.

Body Params
length between 1 and 200

Why the credential is revoked, recorded in the audit trail. Up to 200 characters.

Response

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json