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

# Plan & billing

{% hint style="warning" %}
Requires the **Manage plan & billing** user permission. Plans and billing apply at the workspace level.
{% endhint %}

Go to **Settings → Workspace → Plan & Billing**.

***

## Current plan

Your active plan name and billing amount are shown at the top. Usage counters below show consumption for the current billing period.

| Counter                                                       | Description                                                       |
| ------------------------------------------------------------- | ----------------------------------------------------------------- |
| Monthly [interactions](/docs/getting-started/interactions.md) | Used vs plan limit this month                                     |
| Additional interactions                                       | Pay-as-you-go interactions consumed, and the per-interaction rate |
| Usage reset                                                   | Days until monthly counters reset                                 |
| [Teamspaces](/docs/settings/teamspaces.md)                    | Created vs plan limit                                             |
| [Teams](/docs/settings/general/teams.md)                      | Created vs plan limit                                             |
| [Users](/docs/settings/general/users.md)                      | Invited vs plan limit                                             |
| [AI Agents](/docs/modules/ai-agents.md)                       | Created vs plan limit                                             |

***

## Manage billing

| Action                    | Description                                                                              |
| ------------------------- | ---------------------------------------------------------------------------------------- |
| **Manage billing**        | Opens the Stripe billing portal to update your subscription, add-ons, or payment method. |
| **View invoices**         | Opens the Stripe portal showing past invoices.                                           |
| **Update payment method** | Opens the Stripe portal to change the card on file.                                      |

***

## Upgrade

1. Expand the toolbar by selecting the Proto icon button.
2. Select **Upgrade** next to the monthly interactions counter.
3. Complete checkout on the Stripe page.

## Downgrade

Select **Manage billing** to open the Stripe portal and choose a lower plan.

***

## Voice credits

[Voice API](/docs/developers/apis/voice-api.md) usage (TTS and ASR requests) is billed separately from interactions, against a workspace-level voice credit balance. Each successfully processed request deducts one credit. New workspaces start with a balance of 50 credits.

Manage your credit balance, buy credits, and configure auto top-up from **Settings → Workspace →** [**Voice API**](/docs/settings/general/voice-api.md).

***

## Voice credit alerts

{% hint style="info" %}
Applies only to workspaces that use the [Voice API](/docs/developers/apis/voice-api.md); a workspace that has never made a Voice API call does not receive these alerts.
{% endhint %}

When a workspace's voice credit balance drops below its auto top-up threshold, Proto emails everyone in the workspace who can view billing information.

| Alert               | Sent when                                                     | Repeats                                                 |
| ------------------- | ------------------------------------------------------------- | ------------------------------------------------------- |
| Low balance         | Balance is below the threshold but above zero                 | About once a day, while the balance stays in this range |
| Credits exhausted   | Balance reaches zero                                          | Once, immediately                                       |
| Exhausted follow-up | Balance is still zero roughly a day after the exhausted alert | Once                                                    |

After the follow-up email, alerts stop while the balance stays at zero. They resume once the balance recovers: fully, if it returns to at least the threshold, or partially — skipping straight back to the low-balance reminder — if a top-up leaves the balance above zero but still below the threshold.

If auto top-up is enabled, these alerts are skipped, unless the workspace's most recent automatic top-up failed (for example, a declining card), in which case alerts resume as normal.

### Automatic top-up receipts

Whenever an automatic top-up completes or fails, Proto emails the result to everyone in the workspace who can view billing information, regardless of who triggered or retried it.

### In-product alert

Independently of the email alerts, a warning toast also appears in the app for users who can view billing information. It can appear anywhere in the platform once a user is signed in and a workspace is selected — it is not limited to the billing settings page.

| Alert             | Shown when                                                | Repeats                                                                                                                                                           |
| ----------------- | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Low balance       | Balance is below the auto top-up threshold but above zero | Once per login session, per user and workspace. Dismissing the toast (closing it or selecting **Buy credits**) hides it until the next login or workspace switch. |
| Credits exhausted | Balance reaches zero                                      | Once. Persists across logins and reloads until the balance recovers above zero, after which it can appear again the next time the balance reaches zero.           |

The toast includes a **Buy credits** button that opens the Billing tab of the workspace's Voice API settings (**Settings → Workspace →** [**Voice API**](/docs/settings/general/voice-api.md) **→ Billing**).

Like the email alerts, the toast never appears for a workspace that has never used the Voice API. Unlike the email alerts, it is suppressed for as long as auto top-up stays enabled — there is no equivalent "resumes if the last top-up failed" exception for this toast.