Skip to main content
Budget Limits on Integrations provide a simple way to manage your spending on AI providers (and LLMs) — giving you confidence and control over your application’s costs. They act as financial guardrails, preventing unexpected AI costs across your organisation. These limits cascade down to all AI Providers created from this Integration.

Setting Budget Limits

  1. In your Integration settings, navigate to Workspace Provisioning
  2. Select which workspaces should have access:
    • All Workspaces: Grants access to every workspace in your organisation
    • Specific Workspaces: Choose individual workspaces that need access
  3. Click on the Edit Budget & Rate Limits icon to edit the budget limits for the selected workspace
  4. Set your desired budget Limits
  5. Optionally, Select the Apply to every workspace where this integration is enabled checkbox to apply the same budget limits to all workspaces where this integration is enabled

Cost-Based Limits

Set a budget limit in USD that, once reached, will automatically expire the key to prevent further usage and overspending.

Token-Based Limits

Set a maximum number of tokens that can be consumed, allowing you to control usage independent of cost fluctuations.
Key Considerations for Budget Limits
  • Budget limits can be set as either cost-based (USD) or token-based
  • The minimum cost limit you can set is $1
  • The minimum token limit you can set is 100 tokens
  • Budget limits apply until exhausted or reset
  • Budget limits are applied only to requests made after the limit is set; they do not apply retroactively
  • Once set, budget limits cannot be edited by any organisation member
  • Budget limits work for all AI provider created on the AI Gateway using the given integration

Alert Thresholds

Set alert thresholds to receive notifications before your budget limit is reached:
  • For cost-based budgets, set thresholds in USD
  • For token-based budgets, set thresholds in tokens
  • Receive email notifications when usage reaches the threshold
  • Continue using the key until the full budget limit is reached

Periodic Reset Options

Configure budget limits to automatically reset at regular intervals: Reset Period Options:
  • No Periodic Reset: The budget limit applies until exhausted with no automatic renewal
  • Reset Weekly: Budget limits automatically reset every week
  • Reset Monthly: Budget limits automatically reset every month
Reset Timing:
  • Weekly resets occur at the beginning of each week (Sunday at 12 AM UTC)
  • Monthly resets occur on the 1st calendar day of the month, at 12 AM UTC, irrespective of when the budget limit was set prior

Policy-Based Budgets

The limits above are set on an Integration and cascade to the AI Providers created from it. For finer control — budgets scoped by user, API key, model, provider, or config, and grouped by any of them — use a usage limit policy instead. Policies are defined through the Admin API and evaluated per request. See Usage & Rate Limit Policies for the condition keys, parameters, and twenty worked examples.
Last modified on September 15, 2026