# Budgets

A budget is a dollar limit with an action.

```sh
harebox budget new --limit 50 --scope label:team=web --action stop --period month
harebox budget list
```

| Action | When reached |
|---|---|
| `alert` | Sends `budget.exceeded` |
| `sleep` | Sleeps sandboxes in scope |
| `stop` | Stops them |
| `block_new_starts` | Refuses new starts with `402 budget_exceeded` |

Scopes are `account`, `project:ID`, `fleet:ID`, `label:KEY=VALUE` or `key:ID`. Alerts fire as `budget.threshold`. A new account has no budget; set one before you leave work running.