> For the complete documentation index, see [llms.txt](https://docs.flowcp.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowcp.ai/reference/billing-and-plans.md).

# Billing & plans

The **Billing** tab under **Settings** shows your workspace's current plan, how much of your included usage you've consumed this period, a breakdown of calls per app, and the full list of plans you can compare against.

Billing is **per workspace** (unlike the account-wide [Usage](/reference/account-usage.md) tab).

## Plans

| Plan         | Price/mo | Included calls/mo | Published apps | Overage (per 10k) | Quota behavior     |
| ------------ | -------: | ----------------: | -------------: | ----------------: | ------------------ |
| **Free**     |       $0 |             1,000 |              1 |                 — | Hard cap           |
| **Pro**      |      $39 |            50,000 |              3 |             $1.50 | Soft cap + overage |
| **Team**     |     $149 |           250,000 |             15 |             $1.00 | Soft cap + overage |
| **Business** |     $499 |         1,500,000 |      Unlimited |             $0.60 | Soft cap + overage |

New workspaces start on **Free**. Your current plan is highlighted in the plan list on the Billing tab, and is also shown in the sidebar footer beneath your name for quick reference.

The same tiers are summarized on the public [pricing page](https://flowcp.ai/pricing), which anyone can view without signing in.

## What you're charged for

* **Successful tool calls** are the unit of usage. A call counts only when it succeeds — errors and calls rejected for being over quota are **never** counted.
* **Published apps** are the packaging unit. Each plan caps how many apps you can have published at once; connecting and importing draft apps is unrestricted.

## Current-period usage

The summary at the top of the tab shows, for the current calendar month (UTC):

| Field                 | Meaning                                                               |
| --------------------- | --------------------------------------------------------------------- |
| **Included calls**    | Successful calls used vs. the plan's monthly allowance, with a % bar. |
| **Remaining**         | Included calls not yet consumed this period.                          |
| **Overage calls**     | Successful calls beyond the included allowance (paid plans only).     |
| **Est. overage cost** | Estimated overage charge for the period, priced per 10k calls.        |

Usage resets at the start of each calendar month.

## Quota behavior

* **Hard cap (Free):** once you reach the included allowance, further tool calls are rejected until the next period or an upgrade.
* **Soft cap (paid):** calls beyond the allowance keep working and accrue as overage, billed at the plan's per-10k rate.

## Usage notifications

Workspace **owners** are emailed automatically as usage approaches the plan's included volume:

* **80% used** — a heads-up that you're approaching the included allowance.
* **100% used** — on a hard-cap plan, calls are paused until the next period or an upgrade; on a soft-cap plan, overage billing has started (the email includes the rate and the estimated charge so far).
* **Safety cap reached** — if you've set a hard ceiling on a soft-cap plan and it's hit, calls are paused until you raise or remove the cap.

Each notification is sent **at most once per billing period** and resets when a new period starts (or when you change plans mid-period).

## Payment failures

If a renewal payment fails, the workspace is marked **past due** and we email the workspace **owners** a notice with a link to update the card. Stripe keeps retrying for about two weeks:

* **Included calls keep working** the whole time — a failed payment never cuts off access you've already paid for.
* **Overage is paused.** On soft-cap plans, calls beyond your included volume are rejected while the account is past due, so an unpaid workspace doesn't keep accruing charges. The Billing tab shows a banner explaining this.
* **Recovery is automatic.** As soon as a retry succeeds — or you update the card in the Billing Portal — full access, including overage, is restored and we email a confirmation.
* If every retry fails, Stripe cancels the subscription and the workspace reverts to **Free** at the end of the period.

## Refunds

Refunds issued from the Stripe Billing Portal or dashboard are recorded and shown in your **Billing history**. Workspace owners receive a confirmation email when a refund is processed.

## Billing history

The Billing tab lists recent money-path events — failed and recovered payments, refunds, and apps unpublished after a downgrade — newest first, so you have an at-a-glance record of account activity.

## Calls by app

The Billing tab lists successful calls per connected app for the current period, so you can see which apps are driving your usage. For per-tool and per-agent detail, see [Usage stats](/reference/usage-stats.md) and [Execution logs](/reference/execution-logs.md).

## Changing plans

* **Upgrade** — on the Free plan, each paid tier shows an **Upgrade** button that opens Stripe Checkout. After payment you're returned to the Billing tab and your new allowance, app limit, and overage rate take effect.
* **Manage / change / cancel** — on a paid plan, **Manage billing** (and **Change plan** on the tier cards) opens the **Stripe Billing Portal**, where you can switch tiers, update your payment method, view invoices, or cancel. Cancelling reverts the workspace to Free at the end of the period.

> **Downgrading to a smaller plan?** If you currently have more published apps than the new plan allows, the most recently published apps are automatically unpublished to fit the new limit, and we email you which ones. Re-publish them after upgrading again or unpublishing others first.

If billing isn't configured for the deployment, the tiers show **Contact sales** instead.