Reconciliation

What Invoke does

The action is marked unknown

A timeout, a dropped connection, or an error after the tool accepted the request all count. The reserved budget stays held, since the money may have been spent.

Safe-to-repeat tools are reconciled

Reads, and tools that converge by construction such as linear.update_issue (read first, fixed ids), are safe to run again as the same action. The SDK re-sends the same action, Invoke re-runs it as the same effect, and it lands at most once. You get the receipt.

Everything else waits for a person

For a charge, an email or a new record, running again could act twice. So Invoke refuses to re-run it: the call throws OutcomeUnknownError with safeToRetry: false, and every retry with the same key is refused too. Someone checks the real system and settles it:

curl -X POST "$RESOLVE_URL" \
  -H "X-API-Key: $ACCOUNT_KEY" -H "Content-Type: application/json" \
  -d '{"outcome": "happened", "note": "charge found in Stripe"}'

happened commits the action and seals its receipt. not_happened releases the budget, so an honest retry can run.

In code

import { OutcomeUnknownError } from "@invokehq/sdk"

try {
  await invoke.call({ tool: "stripe.charge_customer", params, idempotencyKey: "invoice:inv_881" })
} catch (err) {
  if (err instanceof OutcomeUnknownError) {
    // err.safeToRetry === false: don't retry. A person settles it at err.resolveUrl.
  } else throw err
}

The agent never writes reconciliation logic, and it never gets a false “failed” that invites a double charge.

Checking live state yourself

If you already hold the live state, such as a Stripe lookup you ran, POST /outcomes/reconcile tells you whether a retry is safe:

curl -X POST https://api.invokehq.run/outcomes/reconcile \
  -H "X-API-Key: $INVOKE_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "action": {
      "intent": "charge_customer",
      "tool": "stripe.charge_customer",
      "params": { "customer_id": "cus_123", "amount": 2400 }
    },
    "outcome": "UNKNOWN",
    "current_state": { "charged": true, "customer_id": "cus_123", "amount": 2400 },
    "conditions": { "charged": true }
  }'

Get Started

Core Concepts

Guides

SDK & CLI

Configuration

Reconciliation

Why not just retry?

What Invoke does

In code

Checking live state yourself

Next steps

​Why not just retry?

​What Invoke does

​In code

​Checking live state yourself

​Next steps

Why not just retry?

What Invoke does

In code

Checking live state yourself

Next steps