Approval Queue

List approval requests

Changed on

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

Request

  • Base URL
    https://api.agentchain.cloud
  • URL
    https://api.agentchain.cloud/api/v1/approvals
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

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

Changes

  • 0d3faa6ef2dbRevision changes
    • breaking

      removed the enum value APPROVED from the query request parameter decision

    • breaking

      removed the enum value DENIED from the query request parameter decision

    • breaking

      removed the enum value EXPIRED from the query request parameter decision

    • breaking

      removed the enum value PENDING from the query request parameter decision

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

  • 3011167788c9Revision changes
    • info

      endpoint added