Revoke an issued credential identified by recipient email + credential
identifier. The credential expires immediately (its expiration date
becomes today in UTC) and its public verification page shows it as expired;
nothing is deleted. If the recipient holds more than one credential of
this template, every active one is revoked. Revoking a credential that is
already expired changes nothing and returns revoked: 0. Revoking does
not consume credits.
When the recipient has several credentials of this template, the response
describes the most recently issued one this request revoked or, when none
was still active, the most recently issued one.
Recent Requests
Log in to see full request history
Time
Status
User Agent
Retrieving recent requests…
Loading…
Responses
404
The recipient has no credential of this template in your account.
422
Three cases, told apart by the body:
validation error: message plus errors, with one list of messages
per invalid field;
plan limit reached (issuing only): error is Customer limit exceeded
and details carries your usage;
credential in Preview (issuing only): code is credential_in_preview.
A Preview credential can only be issued to your organisation's active team
members, as a test credential; details.refused_emails lists the
recipients who are not.
429
Too many requests (60 per minute per token by default). Wait the number of
seconds in the Retry-After header before trying again.
Updated about 1 month ago
Did this page help you?
Yes
No
Language
ShellNodeRubyPHPPython
Credentials
Bearer
Bearer
Loading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
200401404422 - Validation error422 - Plan limit reached422 - Credential in Preview429