Revoke a previously-anchored ZK proof | IDA — Identity for the AI Age

curl -X POST https://adid.dev/api/v1/zkp/proofs/id/revoke \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "proofId": "urn:uuid:8c0f3a3a-4f2b-11ee-be56-0242ac120002",
  "status": "revoked",
  "submittedAt": "2024-01-15T09:30:00Z",
  "proofHash": "0x3a5f7c9d2e4b6a8f1c3d5e7f9a0b2c4d6e8f0a1b2c3d4e5f6a7b8c9d0e1f2a3b",
  "predicateHash": "0x7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c",
  "submitterDid": "did:example:123456789abcdefghi",
  "holderDid": "did:example:abcdef123456789ghi",
  "credentialId": "cred-9876543210abcdef",
  "txHash": "0x9f8e7d6c5b4a39281726354433221100ffeeddccbbaa99887766554433221100",
  "blockNumber": 15873245,
  "confirmedAt": "2024-01-15T09:45:00Z",
  "revokedAt": "2024-02-01T12:00:00Z",
  "revokedBlock": 15873500,
  "failureReason": "",
  "lagBlocks": 5
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

X-API-Keystring

API Key authentication via header

Path parameters

idstringRequired

Request

This endpoint expects an object.

reasonstringOptional

syncWaitMsintegerOptional>=0

Response

proofIdstring

statusenum

Lifecycle state of an on-chain ZK proof anchor row.

Allowed values:

submittedAtdatetime

proofHashstringformat: "^0x[0-9a-fA-F]{64}$"

predicateHashstringformat: "^0x[0-9a-fA-F]{64}$"

submitterDidstring

holderDidstring or null

credentialIdstring

txHashstring or nullformat: "^0x[0-9a-fA-F]{64}$"

blockNumberlong or null>=0

confirmedAtdatetime or null

revokedAtdatetime or null

revokedBlocklong or null

failureReasonstring or null

lagBlocksinteger>=0

Errors

403

Forbidden Error

404

Not Found Error

409

Conflict Error

501

Not Implemented Error