Create Governance Request

POSThttps://sandbox-api.truthlocks.com/v1/governance/issuer-requestsAuth required

Creates a new governance request to perform an action on an issuer. Supported actions include suspend, revoke, reinstate, and change trust tier. Requests may require additional approvals before they can be executed.

Body Parameters

typestringrequired

Type of governance action: SUSPEND_ISSUER, REVOKE_ISSUER, REINSTATE_ISSUER, CHANGE_TRUST_TIER

Defaults to SUSPEND_ISSUER

target_issuer_idstringrequired

The UUID of the issuer to act upon

Defaults to 550e8400-e29b-41d4-a716-446655440000

reasonstringrequired

Justification for the governance action

Defaults to Compliance review required due to policy violation

Responses

{
  "id": "req_abc123",
  "type": "SUSPEND_ISSUER",
  "target_issuer_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "reason": "Compliance review required due to policy violation",
  "created_by": "user:admin@example.com",
  "created_at": "2026-02-18T19:00:00Z"
}

POST/v1/governance/issuer-requests

Language

CredentialsHEADER

Authorization

cURL Request

Examples ▾

curl --request POST \
  --url https://sandbox-api.truthlocks.com/v1/governance/issuer-requests \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
  "type": "SUSPEND_ISSUER",
  "target_issuer_id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "Compliance review required due to policy violation"
}'

Response

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