v15

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

Register approval webhook callback

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

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
}