Read usage and set a spend cap

Goal

Find out how much of your plan you have used this billing period, understand what each meter's status badge means, and, if you want one, set an optional monthly spend cap on overage: once the overage you have run up this period reaches it, new workflow runs pause.

When to use this

Reach for this page when you want to:

• Check how close a workspace is to its included compute, storage, or form-submission limits before the next invoice.
• Find out why a meter shows Throttled, Frozen, or Hard cap.
• See how much of this month's Included AI your AI steps and Draft with AI have used.
• Set, change, or remove the optional monthly spend cap that protects an account from an unexpected overage bill.

The usage dashboard and the spend cap are both account-scoped, reached through any workspace URL. Reading usage is open to any account member. The spend cap is edited at Settings → Spend (/settings/spend) in the Platform spend cap card, which requires the account owner or admin role plus an active paid subscription.

Open the usage dashboard

The plan page lives in the sidebar under Plan & Usage at /settings/billing. Its Usage This Period card shows a single meter, workflow runs used in the current cycle. For the full per-meter breakdown, open the usage dashboard.

1. Open Plan & Usage

   In the workspace sidebar, click Plan & Usage. This opens /settings/billing, the billing overview with your current plan, subscription status, and the workflow-runs card.

2. Open the usage dashboard

   Click View usage to go to /settings/billing/usage. The breadcrumb reads Billing > Usage, and the Billing link returns you to the overview.

3. Read the six meter cards

   The dashboard shows one card per metered dimension: Workflow runs, Compute time, File storage, State storage, Form submissions, and Outbound bandwidth. Each card shows current usage against the amount included on your plan, a status badge, and a projection of where the meter lands by period end.

Each card carries the line Projected by period end: <n> <unit>. Start there when a number looks higher than you expect. Usage counts update periodically, so a meter may trail the most recent runs by a short window.

When a meter shows Unlimited, your plan includes no fixed ceiling for that dimension, so there is no overage to track on it. Active workflows are unlimited on Scale, for example.

Read the overage states

Each meter card carries a status badge. The badge moves through these states as usage climbs toward and past the included amount:

Overage is post-paid: usage above the included envelope is summed at period end and billed on your next invoice. The priced dimensions are compute time, file storage, state storage, outbound bandwidth, and form submissions. Outbound bandwidth counts the request bodies your workflows send to external services plus file downloads from TaskJuice; pages served from custom-branded domains are protected by the same cap but do not count toward the meter today. Workflow runs are counted and shown but are not directly priced, so a high run count alone does not add an overage line. Every run that starts counts as a workflow run, including manual runs, retries, runs started from MCP, and workflows called as tools or sub-workflows. Evaluation test runs and single-step tests do not count. For per-plan inclusions and the exact overage rates, see Understand billing limits and Plans and pricing.

"Setting up overage billing" is temporary

Right after you subscribe or change plans, the usage page may show Overage billing is being set up. with a Refresh button. Your plan is already active while this shows. This is overage billing provisioning itself; it clears on its own. Click Refresh to recheck, or come back later. Once it finishes, the meters render normally.

Set a monthly spend cap

The monthly spend cap is optional. It limits overage: usage beyond your plan's included amounts, priced at your plan's overage rates. Your plan's base price never counts toward it. If your overage this billing period reaches the cap, new workflow runs pause until the next billing period, or until you raise or remove the cap. Runs already in progress finish. The cap is account-scoped and applies across every workspace on the account.

There is no cap by default: without one, overage is billed as used and nothing pauses for spend. The smallest cap you can set is $1, and you can remove a cap at any time.

1. Open the cap dialog

   Open Settings → Spend at /settings/spend and find the Platform spend cap card. With no cap it reads No cap set. Overage is billed as used. and offers Set a cap; with a cap it shows the cap and offers Adjust cap. Either way it shows your overage so far and the overage you are on pace for this cycle (or No overage computed for this cycle yet. before the first run of the period). The Spend tab is available to the account owner and account admins, and the card offers a cap only with an active paid subscription. The billing overview links to Spend settings rather than editing the cap.

2. Enter a cap

   In the Cap (USD per month) field, type the monthly limit in whole dollars. The helper text reads Minimum $1. If the overage you have already accrued this period meets the amount you type, the dialog warns that new runs will pause as soon as you save.

3. Save the cap

   Click Save cap. The new cap takes effect immediately and is stored against the account.

4. Or remove the cap

   When a cap is set, the dialog also offers Remove cap. It lifts the limit immediately, and overage is then billed as used with no pause.

The cap stops new runs; it is not a kill switch. Overage can end up slightly above the cap by the cost of runs already in progress when it is reached, plus a few seconds of usage still being recorded. At a steady spend rate, that is roughly your spend per second multiplied by the time it takes to record usage (normally a few seconds) plus the running time of your longest workflow.

Watch the cap banner

With a cap set, a banner on the billing overview tracks your overage against it. It stays silent while your projected overage for the period is under 80% of the cap. From 80% it turns amber, reads Approaching spend cap, and shows your overage so far and the overage you are on pace for. It never says anything is paused: it is a warning based on your current rate.

Only when your actual overage reaches the cap does the banner turn red:

Spend cap reached. New workflow runs are paused until the next billing period,
or until you raise or remove the cap.

The banner offers Adjust cap (if you can edit it), which opens Settings → Spend, and View usage. The Platform spend cap card on Spend carries the same standing as a badge: Approaching cap from 80%, and Cap reached — new runs paused on the actual pause. Emails follow the same rule: the 60% and 80% notices say you are on pace to use that share of the cap, and the 80% notice can name the date you would reach it at the current rate; only the notice sent on the actual pause says runs are paused. Each notice is normally sent once per period, and changing the cap re-arms them. With no cap, there are no spend-cap notices; the included-usage warnings still arrive as usual.

Included AI

Included AI is the monthly AI model spend your plan pays for: $2 on Free, $5 on Solo, $10 on Starter, $15 on Growth, and $20 on Scale. AI steps with no key of your own attached and Draft with AI share it. The amounts per plan are on Plans and pricing.

Read the Included AI meter

Open Usage & Cost in the account sidebar, at /usage. The Included AI section sits at the top of the page, and every member who can open the page sees it:

• The bar shows spend against the allowance, for example $1.24 / $2.00 (62%). It turns yellow from 80% and red when the allowance is used up.
• The line under the heading reads Account-wide, current month. Resets Nov 1. The meter covers the whole account, client workspaces included, so the period and workspace filters further down the page don't change it.
• The breakdown line splits the spend between Workflow steps and Draft with AI.

When your account has no Included AI, the section is hidden.

When the allowance runs out

Included AI is a hard cap. It never becomes overage and never appears on your invoice, so it doesn't count toward your spend cap either. Once the month's allowance is used up:

• An AI step without a key of your own fails with This month's included AI is used up. Add your own OpenAI or Anthropic key to keep going. The run view and the step test panel offer Add your own key.
• Draft with AI shows the same message and asks for your own key until the 1st.
• The meter shows the same message with an Add your own key link.

The allowance resets at midnight UTC on the 1st of each month. A run that stopped on the cap doesn't restart on its own; run it again after the reset, or after you attach a key.

Your own key always wins

An AI step whose model has your own provider key attached always runs on that key and never touches Included AI, even when allowance is left. That spend goes to your provider bill and shows in the cost dashboard as before. Attach a key to any step you want off Included AI.

What Included AI does not cover

• Spend on your own keys. It is billed by your provider and never counted against the allowance.
• Voice Agent. A Voice Agent always needs your own Google Gemini key.
• Quality checks. Quality checks always need your own AI provider key; a step with no key fails in a quality check with AI_KEY_REQUIRED.

Verify it worked

• On the usage dashboard, each of the six meter cards shows a current value, an included value (or Unlimited), and a status badge. The projection line reads Projected by period end.
• After saving a cap, the Platform spend cap card on Settings → Spend shows the new value; reopen Adjust cap and the Cap (USD per month) field shows it too. After removing the cap, the card reads No cap set. Overage is billed as used.
• The cap banner reflects your new headroom: it stays silent again once your projected overage is back under 80% of the cap, and it disappears entirely when there is no cap.
• In Usage & Cost at /usage, the Included AI section shows spend against your plan's allowance and the date it resets.

Troubleshooting

The save is rejected. A cap must be a whole number of dollars between $1 and $1,000,000. Enter a value in that range and save again. To stop limiting overage altogether, use Remove cap instead of entering zero.

There is no Set a cap or Adjust cap button. Editing the cap requires the account owner or admin role, plus an active paid subscription. Without either role you cannot open Settings → Spend; ask the account owner or an admin to adjust it. On a Free plan the card reads A platform spend cap is available on paid plans.

A meter still shows Setting up overage billing. This provisioning state normally clears within the hour. Click Refresh on the meter. If it has not cleared after an hour, contact support.

New runs stopped because of the spend cap. Reaching the cap refuses new runs while each workflow keeps its status, so there is no workflow to resume. New runs are accepted again as soon as you raise the cap above your overage so far or remove it from Adjust cap, or when the billing period rolls over.

Related

• Understand billing limits for what each meter counts and the per-meter behavior at each threshold.
• Plans and pricing for included amounts and overage rates per plan.
• Manage your subscription to upgrade, downgrade, or update your payment method.