---
title: "POST /usage/v2/budgets/"
method: POST
path: "/usage/v2/budgets/"
tags: ["usage"]
---

# POST /usage/v2/budgets/

`POST /usage/v2/budgets/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/usage/v2/budgets/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

List or create usage budgets.

## Request body

- UsageBudgetMutationRequest
  - `name` string
  - `scope` string
  - `threshold_value` string, decimal
  - `action` 'notify' | 'warn' | 'pause'
  - `notify_emails` string[]
  - `notify_slack_webhook` string, uri, nullable
  - `is_active` boolean

## Response `200`

OK

- UsageBudgetMutationResponse
  - `status` boolean, required
  - `result` UsageBudgetMutationResult, required
    - `id` integer, required
    - `name` string, required
    - `scope` string
    - `threshold_value` string, required
    - `action` string, required
    - `is_active` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)