Budgets

How budgets work

• A budget is a monthly spending cap in cents. 0 means no cap.
• Spend accumulates over a rolling 30-day period; the period resets automatically.
• At the alert threshold (default 80%) the account is flagged alerting.
• If auto-suspend is on and a charge would exceed the cap, the relevant servers are suspended on their panel until the next period or a higher cap.
• New deploys are blocked if they would immediately exceed the cap.

Read your budget

bash
GET /v1/account/budget
→ {
  "budgetCents": 5000,
  "spentCents": 1200,
  "percentUsed": 24,
  "overBudget": false,
  "alerting": false,
  "autoSuspend": true
}

Set your budget

bash
PUT /v1/account/budget
{
  "monthlyBudgetCents": 5000,
  "budgetAlertPercent": 80,
  "autoSuspendOnBudget": true
}

Requires the billing:write scope. The current snapshot is also included in GET /v1/account under budget.

Interaction with credits

Budgets and your credit balance are independent guards. A server is suspended if it runs out of either credits or budget, and revived automatically once both allow it again.