---
title: "New Budget"
method: POST
path: "/budget/new"
tags: ["budget management"]
---

# New Budget

`POST /budget/new`

Create a new budget object. Can apply this to teams, orgs, end-users, keys.

Parameters:
- budget_duration: Optional[str] - Budget reset period ("30d", "1h", etc.)
- budget_id: Optional[str] - The id of the budget. If not provided, a new id will be generated.
- max_budget: Optional[float] - The max budget for the budget.
- soft_budget: Optional[float] - The soft budget for the budget.
- max_parallel_requests: Optional[int] - The max number of parallel requests for the budget.
- tpm_limit: Optional[int] - The tokens per minute limit for the budget.
- rpm_limit: Optional[int] - The requests per minute limit for the budget.
- model_max_budget: Optional[dict] - Specify max budget for a given model. Example: {"openai/gpt-4o-mini": {"max_budget": 100.0, "budget_duration": "1d", "tpm_limit": 100000, "rpm_limit": 100000}}
- budget_reset_at: Optional[datetime] - Datetime when the initial budget is reset. Default is now.

## Request body

- BudgetNewRequest
  - `budget_id` string, nullable — The unique budget id.
  - `max_budget` number, nullable — Requests will fail if this budget (in USD) is exceeded.
  - `soft_budget` number, nullable — Requests will NOT fail if this is exceeded. Will fire alerting though.
  - `max_parallel_requests` integer, nullable — Max concurrent requests allowed for this budget id.
  - `tpm_limit` integer, nullable — Max tokens per minute, allowed for this budget id.
  - `rpm_limit` integer, nullable — Max requests per minute, allowed for this budget id.
  - `budget_duration` string, nullable — Max duration budget should be set for (e.g. '1hr', '1d', '28d')
  - `model_max_budget` object, nullable — Max budget for each model (e.g. {'gpt-4o': {'max_budget': '0.0000001', 'budget_duration': '1d', 'tpm_limit': 1000, 'rpm_limit': 1000}})
  - `budget_reset_at` string, date-time, nullable — Datetime when the budget is reset

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/79928a3d37d3/schema)