# AI Gateway now supports team and project spend budgets

**Published:** July 31, 2026 | **Authors:** Jeremy Philemon, Joe McKenney, Jerilyn Zheng | **Contributors:** Kevin Sundstrom

---

AI Gateway spend budgets can now be scoped to a team or a project, in addition to individual API keys. Set a dollar limit on a scope, and the gateway meters spend against it and stops further requests once the limit is reached, until the budget resets or you raise it.

![Track spend against every team, project, and key budget from one overview.](//images.ctfassets.net/e5382hct74si/26VMVwRso0PltsXsvRVZUZ/04d469ae744fc541f5220bdb92f5282d/3b68d3da-4474-48eb-b69d-ef4aeba13295.png)
*Track spend against every team, project, and key budget from one overview.*

## Scopes

A budget attaches to one of three scopes. A request can fall under multiple budgets and has to pass all of them: if any one is over its limit, the request is rejected, even when the others have room left.

| Scope | Caps spend for |
| --- | --- |
| Team | Every request your team runs through the gateway |
| Project | All requests attributed to a single project |
| API key | A single API key |

BYOK spend is not counted against budgets by default.

## Manage budgets in the dashboard

Set and track budgets from the [AI Gateway Budgets tab](https://vercel.com/d?to=%2F%5Bteam%5D%2F%7E%2Fai-gateway%2Fbudgets&title=AI+Gateway+Budgets). The Overview breaks spend down across every scope against its limit, so you can see what is near or over before it starts rejecting requests.

![See budget health and refresh cadence across every scope at a glance.](//images.ctfassets.net/e5382hct74si/56pRGkRU16tAJjJPemXpR2/5d47911a214447b31476b28c0ec71f09/e2030be3-94ef-4712-9a1a-5f653abd4408.png)
*See budget health and refresh cadence across every scope at a glance.*

Turn on email spend alerts to notify your team's usage notification recipients when usage crosses 50%, 75%, or 100% of a limit within a refresh period. Alerts are off by default and informational: they never block requests, only the budget limit does.

![Set a per-project or per-API key budget with refresh periods and email notifications.](//images.ctfassets.net/e5382hct74si/2gqw3zZOc5YzYsNUmxggkg/4888194b77f0d406569555ef8c5eab8b/c3b9afe0-8b02-41b4-9fdf-fff96b64f2aa.png)
*Set a per-project or per-API key budget with refresh periods and email notifications.*

Set a default budget for projects or API keys, and every one without an explicit budget inherits it automatically. An explicit budget always overrides the default.

![Track spend against every budget from the dashboard.](//images.ctfassets.net/e5382hct74si/4JmlMMPpSFrDvNZNjSx6P5/3cfb234024b845286d439b2e0bbea957/48281962-b2c8-4b65-a8f7-62c043db2b01.png)
*Track spend against every budget from the dashboard.*

## Manage budgets from the CLI

Set, inspect, and remove team and project budgets from the CLI. The refresh period is `daily`, `weekly`, `monthly` (default), or `none` for a cumulative cap.

```bash
# Set a team budget
vercel ai-gateway budgets set team --limit 500 --refresh-period monthly

# Scope a budget to a single project
vercel ai-gateway budgets set project my-project --limit 200 --refresh-period monthly

# Set a default for projects or keys without their own budget
vercel ai-gateway budgets defaults set project --limit 200 --refresh-period monthly

# List every budget
vercel ai-gateway budgets list

# Remove a budget
vercel ai-gateway budgets remove team
```

For more information, read the [budgets documentation](https://vercel.com/docs/ai-gateway/observability-and-spend/budgets).

---

📚 **More updates:** [View all changelog entries](/changelog/sitemap.md) | [Blog](/blog/sitemap.md)