---
title: "Update Budget"
method: POST
path: "/budget/update"
tags: ["budget management"]
---

# Update Budget

`POST /budget/update`

Update an existing budget object.

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] - Update the Datetime when the budget was last reset.

## 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/1e929292ddd5/schema)