---
title: "Upsert AI Gateway budget default"
method: PUT
path: "/ai-gateway/budgets/defaults"
tags: ["ai-gateway"]
---

# Upsert AI Gateway budget default

`PUT /ai-gateway/budgets/defaults`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/ai-gateway/budgets/defaults`
- Auth: HTTP bearer

Create or update an AI Gateway budget default for one scope. Team-level authority only (owners/admins).

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `scopeType` 'team' | 'project' | 'api-key' | 'user', required
  - `limitAmount` number, required: Default budget limit in dollars.
  - `refreshPeriod` 'daily' | 'weekly' | 'monthly' | 'none'
  - `alertThresholds` number[]

## Response `200`

- AiGatewayBudgetDefault
  - `active` false | true, required
  - `alertThresholds` number[]
  - `createdAt` number, required
  - `limitAmount` number, required
  - `refreshPeriod` 'daily' | 'monthly' | 'none' | 'weekly', required
  - `scopeType` 'api-key' | 'project' | 'team' | 'user', required
  - `updatedAt` number, required

## Other responses

- `400`: One of the provided values in the request body is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`
- `500`

## Changes

- **2026-09-30** `6f68095b42b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/api/changes/ai-gateway/budgets/defaults/put.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) - [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/api/revisions/4a06e85c2848?raw)