Budgets
The Budgets page lets you set spending limits for individuals, teams, or the organization.
Soft caps
Section titled “Soft caps”Soft caps trigger a warning but don’t block usage.
When triggered:
- The developer sees a warning in their next session
- An alert appears in the dashboard
- Optional: notification sent via webhook
Use cases:
- Alerting developers when they’re spending more than usual
- Giving team leads visibility into budget consumption
- Early warning before hitting hard limits
Hard caps
Section titled “Hard caps”Hard caps block API requests when the limit is reached.
When triggered:
- The gateway returns a 429 (rate limited) response
- The developer sees a “budget exceeded” message
- Usage is blocked until the next budget period or an admin increases the limit
Use cases:
- Preventing runaway costs from long sessions
- Enforcing per-developer or per-project limits
- Protecting shared budgets
Budget periods
Section titled “Budget periods”| Period | Resets |
|---|---|
| Daily | Midnight UTC |
| Weekly | Monday midnight UTC |
| Monthly | First of month midnight UTC |
Configuration
Section titled “Configuration”Set budgets from the dashboard:
- Navigate to Budgets
- Select scope: organization, team, or individual developer
- Set soft cap amount (dollars)
- Set hard cap amount (dollars)
- Choose budget period
- Save
Monitoring
Section titled “Monitoring”The budgets page shows:
- Current spend vs. cap (progress bar)
- Projected end-of-period spend (based on current rate)
- History of budget utilization
- Alert log (when caps were triggered)