Skip to content

Run Balance

Run Balance is the execution quota consumed whenever you run tools or agents. It’s separate from your Wallet, which holds withdrawable cash. Run Balance is what powers the work; the Wallet is money.

Run Balance comes in two buckets:

  • Expirable — from monthly plan allotments and promotional credits. Unused amounts expire on their expiration date.
  • Non-expirable — from top-ups and manual grants. Persists through plan changes and cancellations.

Each tool or agent run deducts from your Run Balance based on that tool’s run cost (compute plus any creator-set fee). The Transactions record logs every charge with its status, method, and date.

Top Up moves Wallet funds into Run Balance or buys quota directly by card; the funds land in your non-expirable bucket immediately. (Separately, Add Funds deposits money into your Wallet for later use.)

Trying to run a tool or agent with zero Run Balance returns a “402 Payment Required” and blocks execution — but your tools, agents, and data stay intact; only running is paused. Resolve it by topping up, upgrading the plan for a larger monthly allotment, or adding funds to the Wallet and topping up from there.

For an enterprise, Run Balance is shared across the organization and an admin manages it centrally — one place to watch consumption, top up before work stalls, and connect usage to the teams driving it. Pair it with Cost controls so consumption maps to value.

An admin sees Run Balance drawing down faster than usual, checks usage analytics, and finds a newly popular workflow driving it. Because it’s clearly producing value, they top up and set a budget alert — informed, not blindsided.