Quick Start

export INVOKE_API_KEY=inv_live_…

npm install @invokehq/sdk

import { Invoke } from "@invokehq/sdk"

const invoke = Invoke.fromEnv()

const done = await invoke.call({
  tool: "stripe.charge_customer",
  params: { customer_id: "cus_123", amount: 2400, currency: "usd", invoice_id: "inv_881" },
  idempotencyKey: "invoice:inv_881",
})

console.log(done.status, done.receipt.number) // committed #5e4a967b

for (const stage of (await invoke.trace(done)).stages) {
  console.log(stage.label, stage.value)
}
// Agent     your-agent
// Identity  key-bound
// …
// Policy    allowed
// Budget    reserved
// Action    stripe.charge_customer
// Result    committed
// Receipt   #5e4a967b

​

What just happened

• Safe. Before the charge ran, Invoke checked the agent’s identity and permissions, your workspace policies and the budget. It reserved the cost, ran the tool once, then settled.
• Attributable. The charge is recorded as your agent’s. The key proves it, not a name anyone could type.
• Observable. invoke.trace() returns each stage of the run, read back from Invoke’s ledger.
• Verifiable. The receipt was signed when the action committed. done.receipt.verified tells you the ledger still matches what was signed.

​

Prefer the terminal?

npm install -g @invokehq/cli
invoke login

​

Next steps

• TypeScript SDK: the full reference, including errors, approvals and idempotency
• How It Works: what Invoke checks before an action runs
• Payments: charges that can’t happen twice