v15

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-287323136.0 KB

Approval Queue

List approval requests

Returns pending approval requests for the authenticated operator. Filter by decision status (PENDING, APPROVED, DENIED, EXPIRED). Defaults to PENDING. Auto-expires stale approvals past their TTL.

get/api/v1/approvals

Query parameters

decisionstring

Filter by decision status: PENDING, APPROVED, DENIED, EXPIRED (default: PENDING)

Response

List of approval requests

idstring

Approval request ID

taskIdstring

Associated task ID

agentIdstring

Agent that submitted the action

actionTypestring

operationstring

targetstring

Counterparty or resource

requestedValuenumber nullable

currencystring nullable

triggerPolicystring

triggerReasonstring

decision'PENDING' | 'APPROVED' | 'DENIED' | 'EXPIRED'

createdAtstring date-time

expiresAtstring date-time nullable

Example response

[
  {
    "actionType": "spend_control",
    "operation": "invoice_payment",
    "requestedValue": 12000,
    "currency": "USDC",
    "triggerPolicy": "human_approval_threshold",
    "triggerReason": "$12,000 exceeds auto-approve limit of $5,000"
  }
]