Skip to main content
POST
/
v1
/
attestations
/
{id}
/
revoke
Revoke Attestation
curl --request POST \
  --url https://api.truthlocks.com/v1/attestations/{id}/revoke \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "reason": "Certificate holder no longer employed"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "issuer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kid": "<string>",
  "status": "VALID",
  "payload": {},
  "signature": "<string>",
  "log_index": 123,
  "created_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
Parameters

​
id
string
required
The UUID of the attestation to revoke
​
reason
string
Optional reason for revocation (recorded in audit log)

​
Responses

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
id
string<uuid>
required

Body

application/json
​
reason
string

Optional reason for revocation

Response

Attestation revoked

​
id
string<uuid>
​
issuer_id
string<uuid>
​
kid
string
​
status
enum<string>
Available options:
VALID,
REVOKED,
SUPERSEDED
​
payload
object
​
signature
string
​
log_index
integer
​
created_at
string<date-time>