Revoke Attestation

POSThttps://sandbox-api.truthlocks.com/v1/attestations/{id}/revokeAuth required

Revokes an attestation, marking it as invalid for future verification. This action is recorded in the transparency log and cannot be undone. Existing proof bundles will show REVOKED status.

Path Parameters

idstringrequired

The UUID of the attestation to revoke

Defaults to 660e8400-e29b-41d4-a716-446655440001

Body Parameters

reasonstring

Optional reason for revocation (recorded in audit log)

Defaults to Certificate holder no longer employed

Responses

{
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "status": "REVOKED",
  "revoked_at": "2026-01-13T15:00:00Z",
  "revocation_reason": "Certificate holder no longer employed"
}

POST/v1/attestations/{id}/revoke

Language

CredentialsHEADER

Authorization

cURL Request

Examples ▾

curl --request POST \
  --url https://sandbox-api.truthlocks.com/v1/attestations/660e8400-e29b-41d4-a716-446655440001/revoke \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
  "reason": "Certificate holder no longer employed"
}'

Response

Click Try It! to send a real request, or view sample responses: