Skip to main content
POST
/
v1
/
governance
/
issuer-requests
Create issuer governance request
curl --request POST \
  --url https://api.truthlocks.com/v1/governance/issuer-requests \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'
{
  "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"
}
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.

​
Parameters

​
type
string
required
Type of governance action: SUSPEND_ISSUER, REVOKE_ISSUER, REINSTATE_ISSUER, CHANGE_TRUST_TIER
​
target_issuer_id
string
required
The UUID of the issuer to act upon
​
reason
string
required
Justification for the governance action

​
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"
}

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json

The body is of type object.

Response

201

Request created