HUhumbleaf
Approval Queue

Register approval webhook callback

Changed on

Register a one-shot callback URL for a specific approval request. When resolved, AgentChain POSTs the result with dual-signature headers: x-agentchain-signature (HMAC-SHA256 for web2 verification) and x-agentchain-eip712-sig (EIP-712 for crypto-native verification). The callback fires once and is then deleted. Primary use case: Trigger.dev wait.forToken() integration for zero-cost checkpoint-resume approval flows.

post/api/v1/approvals/{id}/callback

Request

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

Path parameters

idstring required

Approval request ID

Request body

callbackUrlstring uri required

URL to receive the webhook POST when the approval is resolved

Example request

{
  "callbackUrl": "https://api.trigger.dev/wait/token/abc123"
}

Response

Callback registered

registeredboolean
approvalIdstring

Example response

{
  "registered": true
}

Changes