[Docs index](/docs.md) / [Workspace Billing](/docs/workspace-billing/overview.md) / Configuring Automatic Top-Ups

---

# Configuring Automatic Top-Ups

Set up automatic top-ups so your workspace balance stays funded without manual intervention.

## Before you begin

- You must be a workspace administrator.
- A payment method must be saved to your workspace. If you have not added one yet, see [Setting up a payment method](setting-up-a-payment-method.md).

## Top-up modes

| Mode | How it works |
|------|-------------|
| Minimum Balance | Automatically adds credits when your balance drops below a set threshold |
| Monthly | Adds a fixed credit amount once per month |
| None | No automatic top-ups; credits must be added manually |

## Steps

### 1. Open the billing panel

Navigate to the **Workspace** page. The **Billing** section appears below the active workspace card.

### 2. Select a top-up mode

In the **Automatic Top-Up** card, select one of the three options:

- **Minimum Balance** (recommended) -- select this to keep your balance above a minimum threshold
- **Monthly** -- select this to add a fixed amount each month
- **None** -- select this to disable automatic top-ups

A configuration dialog opens after selecting **Minimum Balance** or **Monthly**.

### 3. Configure the settings

**For Minimum Balance mode:**
- Enter the **Minimum Balance (USD)** -- the threshold that triggers a top-up. Must be at least $20.
- Enter the **Top-Up Amount (USD)** -- the amount added when the balance drops below the threshold. Must be greater than $0.

**For Monthly mode:**
- Enter the **Monthly Top-Up Amount (USD)** -- the fixed amount added each month. Must be greater than $0.

**For None:**
- The dialog confirms that automatic top-up will be disabled. No additional configuration is needed.

### 4. Confirm the configuration

Click **Continue**. The setting is saved and takes effect immediately.

If the button opens a payment method dialog instead, your workspace does not have a saved payment method. Complete the payment setup first, then the top-up configuration is applied automatically.

See [Troubleshooting](troubleshooting.md) if you encounter issues saving your configuration.

---

## Navigation

### In this section: Workspace Billing

- [Workspace Billing](/docs/workspace-billing/overview.md)
- [Adding Credits](/docs/workspace-billing/adding-credits.md)
- [Setting Up a Payment Method](/docs/workspace-billing/setting-up-a-payment-method.md)
- **Configuring Automatic Top-Ups** (current)
- [Viewing Usage and Costs](/docs/workspace-billing/viewing-usage-and-costs.md)
- [Troubleshooting](/docs/workspace-billing/troubleshooting.md)

### Other sections

- [Tool Creation](/docs/tool-creation/overview.md)
- [Subagents](/docs/subagents/overview.md)
- [Agent Skills](/docs/agent-skills/overview.md)
- [Sandcastles](/docs/sandcastles/overview.md)
- [MCP Servers](/docs/mcp-servers/overview.md)
- [Scheduled Triggers](/docs/scheduled-triggers/overview.md)
- [Agent Filesystem](/docs/agent-filesystem/overview.md)
- [Tool Policies](/docs/tool-policies/overview.md)
- [Workspace Permissions](/docs/workspace-permissions/overview.md)
- [Chat Sharing](/docs/chat-sharing/overview.md)

[Back to docs index](/docs.md)