v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB

Credentials

Bulk-revoke every live credential issued under this schema version (destructive).

Bulk revoke live credentials issued under one schema version. Use this carefully because it is destructive for affected credentials. The response tells you how many credentials were revoked.

post/v1/credential-schemas/{uuid}/revoke-credentials

Path parameters

uuidstring required

UUID of the credential schema version whose credentials you want to revoke.

Request body

object required

Response

The credentials issued under this schema version were revoked.

revokedinteger

Number of credentials revoked by the bulk operation.

schema_idstring uuid

UUID of the schema version used for the bulk revoke.

versionstring

Version string of the schema version used for the bulk revoke.

Example response

{
  "revoked": 1,
  "schema_id": "c24a6fbe-3375-42d0-aead-c5f628f6a18d",
  "version": "1.0"
}