Skip to main content

Billing settings

Where to find it: Settings → Workspace → Billing (/settings/workspace/billing). Anyone who can view billing can open it. Most controls are read-only unless you can manage billing.

This is the plan and payment side of billing. Here you subscribe, pay, and buy credits. Want to see how those credits actually get spent? That reporting (runs, tokens, and spend by project, model, and agent) lives on the Usage page.

View-only vs. manage

If you can only view billing, you see a stripped-down panel: just the current plan name and subscription status. Everything below describes the full view shown to users who can manage billing. That is the workspace Owner, or an Admin or Member explicitly granted "Manage billing" (see People and access).

Top bar​

Billing portal (top right) opens Stripe's hosted billing portal in a new tab, where you manage saved payment methods and other Stripe-native account details. It shows "Billing portal unavailable." if it fails to open.

Status banners​

These appear conditionally above the plan details:

  • Confirming payment with Stripe… appears briefly right after you return from a Stripe checkout, while the payment is verified.
  • Success banner: "Subscription activated successfully!" or "Credits purchased successfully!" depending on what was just bought. It has a Dismiss link.
  • Past-due banner: "Your last payment failed. Please update your payment method to keep your subscription active," with an Update payment button that opens the billing portal.
  • Cancellation-pending banner: "Your subscription will be cancelled on [date]. After that you'll be moved to the Free plan," with an Undo cancellation button.

Current plan​

A card showing:

  • A CURRENT badge and the plan name.
  • A status badge if the subscription is not in good standing, for example "past_due".
  • The monthly credit allotment for the plan. If this workspace's free monthly allotment is already assigned to another workspace owned by the same user, a note explains that the workspace currently gets 0 monthly credits and needs a credit pack or an upgrade to be funded. (Each user gets one free allotment, which prevents farming.)
  • A Cancel plan link (Owner only, paid plans only, hidden if a cancellation is already pending). It opens a "Cancel [plan] plan?" dialog warning that access continues until the end of the billing period, after which the workspace moves to Free. The dialog has Keep subscription and Cancel plan buttons.

Next to the plan card, a credits remaining tile shows the total available credits (plan allotment plus purchased pack credits), when the plan credits reset, and turns orange with a low-balance warning under 50 credits. If any credits are currently held by active runs (reserved, not yet spent), a separate notice states how many.

All plans​

A row of plan cards, one per available plan, each showing:

  • The plan name, with a badge where applicable (CURRENT, MOST POPULAR, BUSINESS).
  • Price per seat per billing interval, or "Custom pricing" for plans without a fixed price.
  • The monthly credit allotment.
  • A call-to-action button:
    • Subscribe → starts Stripe checkout for that plan.
    • Manage subscription appears on the current paid plan and opens the billing portal instead of starting a new checkout.
    • Active plan (disabled) appears on the current Free plan, since there is nothing to subscribe to.

If a plan change fails, for example because the payment provider is unreachable, an inline error appears above the plan cards.

How do I buy extra credits?​

A card for one-time credit pack purchases:

  • Shows the current pack credits balance. Purchased credits never expire and are used only after plan credits run out.
  • Three selectable credit-pack options, shown as price and credit-count tiles. Click one to select it (highlighted border).
  • Buy credits → is disabled until a pack is selected, then redirects to Stripe checkout for that pack. It shows "Redirecting…" while processing.
  • An inline error appears if the purchase cannot be started.

How do project budgets work?​

A card for capping how many credits an individual project can draw from the shared workspace pool per period. Credits never leave the pool: a budget is just a ceiling.

  • Existing budgets are listed with the project name and a progress bar of credits consumed vs. the limit. A bar turns red with "— runs blocked" once exhausted.
  • A trash icon on each budget removes it, returning that project to unrestricted, shared-pool access.
  • To add a budget: pick a project from the Select a project… dropdown (already-budgeted projects are hidden unless currently selected), enter a credits-per-period number, and click Set budget.

Invoice history​

A read-only table of past invoices: date, type, amount, and status (paid, open, void, uncollectible, or draft, each a colored badge). Each invoice with a hosted PDF has a PDF link that opens it in a new tab. Shows "No invoices yet." when empty.

Credit history​

Collapsed by default behind a Show credit history / Hide credit history toggle. When expanded, it shows a paginated table of every credit ledger entry:

  • Date, reason (grant, purchase, reserve, debit, refund, expiry, or adjustment, each color-coded), amount (plus or minus), balance after the entry, and a description (or the run ID that consumed the credits).
  • Prev and Next buttons page through history. This is cursor-based, so "Prev" is disabled on the first page.
On this page