Skip to main content

​
check_approval_status

Check the status of an escalated approval request.

​
Input

​
Behavior

Use the approval_request_id from an APPROVAL_REQUIRED response. The result shape is:
  • approval_id
  • status: pending, approved, denied, or expired
  • requested_at, expires_at
  • approval_token: only when approved and not yet consumed
  • denied_reason
  • spend_context: { url, intent, amount_usdc } from the original spend request

​
consume_approval_token

Fetch the short-lived token needed for retry.

​
Input

​
Behavior

Returns the approval_token that must be passed back into the retrying governed_fetch call.
This call is read-only and idempotent. The retrying governed_fetch call performs the actual token consumption against the matching request context. In most flows, prefer check_approval_status because it surfaces the token and the approval state in one step.

​
wait_for_approval_resolution

Long-poll until a pending approval transitions to approved, denied, expired, or until the wait times out. Use this when the caller cannot receive webhooks and you want the server to block instead of polling from the client.

​
Input

​
Behavior

  • First check runs immediately
  • Then AXON polls roughly once per second
  • On timeout, the tool returns status: "pending" plus timed_out: true
  • When approved and unconsumed, the response includes approval_token

​
Approval Flow Example