---
title: "Set Enterprise Budget"
method: PUT
path: "/api/billing/enterprise/budget"
tags: ["Billing"]
---

# Set Enterprise Budget

`PUT /api/billing/enterprise/budget`

Set or update a monthly budget for an enterprise API key.

Budget is a soft cap (alerts only); hard limit is admin-set credit_limit_usd.
Pass monthly_budget_usd=null to remove the budget (unlimited spending).

## Headers

- `X-API-Key` string, nullable

## Request body

- EnterpriseBudgetUpdate
  - `api_key_id` string, required — API key UUID to update
  - `monthly_budget_usd` number, nullable — Monthly budget in USD. Set to null/None to remove budget (unlimited).

## Response `200`

Successful Response

- EnterpriseBudgetResponse
  - `success` boolean
  - `message` string, nullable
  - `api_key_id` string, nullable — API key UUID
  - `api_key_name` string, nullable — API key name
  - `monthly_budget_usd` number, nullable — Monthly budget (null = unlimited)
  - `current_month_usage_usd` number, nullable — Current month's usage
  - `budget_utilization_percent` number, nullable — Percentage of budget used (null if no budget)
  - `is_over_budget` boolean — Whether current usage exceeds budget

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/compresr/apis/compresr-platform-api.md) · [All operations](https://skmtc.net/compresr/apis/compresr-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/compresr/compresr-platform-api/revisions/93ee959dfa51/schema)