> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bead.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox API key budgets

> Set sandbox API key budgets and understand lifetime spending ceilings, reservations, and organization funds.

Use sandbox API key budgets to set optional lifetime ceilings on funded work attributed to credentials. These budgets are separate from the organization's prepaid funds.

## How a budget is consumed

The ceiling covers consumed credit plus outstanding reservations. It has no automatic daily or monthly reset. A request must fit both the key budget and the organization's available funds.

For example, a key can hit its ceiling while the organization still has credit. Adding organization credit does not increase that key's ceiling.

## Commitments stay with their budget

A second key cannot move an existing machine's commitments to a different budget. Lifecycle work remains charged to the original budget. Credential rotation preserves the durable budget identity rather than resetting consumption.

A budget does not mint or earmark organization funds. Several credentials can share access to the same organization balance; that balance remains the overall funding constraint.

## Check a refusal

```bash theme={null}
bead balance
bead limits
```

Inspect the returned funding or admission error. Distinguish an exhausted key ceiling from insufficient organization credit and from resource limits. Use an appropriately authorized credential for new work after the account's budget authority is resolved.

Inspect your [key metadata](https://docs.bead.run/platform/api-keys.md) with admin authority when diagnosing credential constraints.

See [API keys and scopes](https://docs.bead.run/platform/api-keys.md), [Prepaid credit](https://docs.bead.run/platform/prepaid-credit.md), and [Credit and payment problems](https://docs.bead.run/help/credit.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.