Skip to main content

Credits

Credits are the prepaid unit that funds the platform's AI features. Every plan includes a monthly credit grant, and you can purchase additional credits at any time.

What consumes credits

  • Agent sessions — hosted agent runs (dispatch, routines, delegated sessions).
  • The workspace assistant — conversational turns and supervision.
  • Blueprint bootstraps — building a product baseline from a blueprint consumes a one-time amount per bootstrap.

Consumption varies with the model used, the blueprint selected, and the size of the task. Sessions running on your own model API keys (a connected Anthropic/OpenAI/OpenRouter account) do not consume credits for model tokens — your provider bills those directly; the platform meters only its own compute.

Everything else — deployments, the catalog, logs, events, webhooks — does not consume credits. Those are covered by your plan's included allowances.

How the balance works

  • Plan credits are granted at the start of each billing cycle and reset at the end of it — they do not roll over.
  • Purchased credits (top-ups) roll over and are consumed only after your plan credits, expiring 12 months after purchase.
  • The balance lives at the account: all workspaces under one account share a single balance, and each workspace's consumption is attributed in the credit activity view.

When the balance reaches zero, new agent sessions, assistant turns, and bootstraps are declined with a top-up prompt; running sessions are asked to wrap up gracefully — never cut off mid-action. Everything outside the AI plane keeps working.

Topping up

Settings → Billing → Credits shows the balance, the current cycle's consumption, and the available top-up packs. A top-up is a one-time purchase through the same checkout as plan changes; credits arrive within a minute of payment confirmation.

Low-balance notifications

When the wallet dips below the low-balance threshold, the platform emits a billing.credits.low_balance event — once per dip, re-armed when the balance recovers (a new grant or a top-up). Create a notification rule for that event type (Settings → Notifications) to get an email or Slack message before sessions start being refused. There is no automatic reload: credits are only ever purchased by an explicit checkout you confirm — topping up stays one click from the billing page.

For workspace admins

  • The credit activity list shows every grant and consumption entry with its workspace attribution — amounts only, by design.
  • A declined action returns 412 credits_exhausted on the API, with the top-up path in the error payload.
  • Enterprise accounts receive pooled custom grants — talk to your account contact.