Sign in
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
}

Changes

Changed in 2 of the 15 revisions of this API.3

  • 0d3faa6ef2db2See the full diff
    • ○

      removed the non-success response with the status 400

      response-non-success-status-removed

    • ○

      removed the non-success response with the status 401

      response-non-success-status-removed

  • 3011167788c91See the full diff
    • ○

      endpoint added

      endpoint-added