Budgets
Budgets let you control how much your project spends on AI requests. You can set spending limits at different levels for the whole project, per team, per user, or per API key and choose daily, weekly, or monthly time windows. When a limit is reached, further requests are blocked until the window resets.
Budget Scopes
A budget rule always targets a specific scope that determines what it applies to:
Project
Total combined spend across the entire project
Team - All teams
The same limit applied separately to every team in the project
Team - Specific team
A limit for one selected team
User - All users
The same limit applied separately to every user in the project
User - Specific user
A limit for one specific user
API Key - All API keys
The same limit applied separately to every API key in the project
API Key - Specific key
A limit for one specific API key
DEPRECATION NOTE If you created your API key before the 1st of May 2026, you need to rotate it (delete and recreate) for API key-level budget tracking to work correctly. Keys created after that date work automatically.
Budget Periods
Each rule uses one of three time windows. Spend counters reset automatically at the start of each window (UTC time):
Daily
Midnight UTC
Weekly
Monday 00:00 UTC
Monthly
1st of the month, 00:00 UTC
You can combine multiple periods on the same target. For instance, you could set both a daily limit of €5 and a monthly limit of €100 for a user.
Viewing Budget Rules
To view the defined budget rules:
Navigate to Settings
Select the Budgets tab.
The Budgets tab in your project settings shows all active budget rules as cards. Each card displays:
A scope (blue for Project, green for Team, purple for User, amber for API Key)
The target (e.g. Project, a user's name, or an API Key)
The period (Monthly, Weekly, or Daily)
The current limit in EUR
A utilization bar showing how much of the budget has been used
Creating a Budget Rule
Only project administrators can create, edit, or delete budget rules. Regular users can view the rules that apply to them and their own utilization.
Click the "Add budget rule" button at the bottom of the budget rules list
Configure the Target section:
Scope: Choose Project, Team, User, or API Key
Team (appears for Team scope): Select a specific team, or leave it as "All teams" to apply the same limit separately to every team
User (appears for User and API Key scopes): Select a specific user, or leave as "All users" / "All API keys" to create a default rule
API Key (appears when a specific user is selected under API Key scope): Pick one of the user's API keys
Configure the Limit section:
Period: Choose Daily, Weekly, or Monthly
Amount (EUR): Enter the spending cap (minimum €0.01)
Click Create
If a rule already exists for the same target, the new period will be added alongside existing ones rather than replacing them.
Editing a Budget Rule
To update an existing rule's limit:
Change the EUR amount in the input field on the rule card
Click Save
The new limit takes effect immediately. Current utilization is not reset, only the cap changes.
Deleting a Budget Rule
To remove a rule:
Click the trash icon on the rule card
The rule is removed immediately
If the rule was the last period on a target (e.g. you delete a user's only monthly limit), the entire budget configuration for that target is cleaned up automatically.
What Happens When a Budget Is Exceeded
When a request would cause spending to exceed a budget limit:
The request is blocked with an error message indicating which budget was exceeded
The message includes the time remaining until the budget window resets
Once the window resets (e.g. a new day, week, or month), spending is allowed again
Visibility for Non-Admin Users
Regular (non-admin) users can see:
✅ Project-wide budget rules and utilization
✅ "All teams" rules for teams they belong to
✅ "All users" and "All API keys" rules with their own utilization only
✅ Budget rules that specifically target one of their teams
✅ Budget rules that specifically target them
They cannot see budget rules or utilization data for other users or teams to which they are not assigned.
Automatic Cleanup
Budget rules are automatically removed when their target no longer exists:
Removing a member from a team deletes budgets associated with that member's team assignment
Deleting a team deletes all budget rules targeting that team
Removing a user from the project deletes all budget rules targeting that user
Deleting an API key deletes the budget rule for that key
Deleting a project removes all associated budget rules
Last updated