---
title: "Update Spend Limits"
method: POST
path: "/v1/admin/spend-limit"
tags: ["beta.admin.billing"]
---

# Update Spend Limits

`POST /v1/admin/spend-limit`

Update the Organization usage limit.

## Request body

- NewUsageLimitIN
  - `amount` integer, required — New monthly usage limit amount.
  - `no_monthly_limit` boolean — Whether to remove the monthly usage limit.

## Response `200`

OK

- LimitsOUT
  - `limits` LimitsContext, required
    - `completion` UsageLimits, required
      - `no_monthly_limit` boolean — Whether no monthly usage limit is configured.
      - `monthly_limit_reached` boolean, required — Whether the monthly usage limit has been reached.
      - `usage` number, nullable — Current usage counted against the limit.
      - `vibe_usage` number, nullable — Current Vibe usage counted against the limit.
      - `total_usage` number, nullable — Total current usage counted against the limit.
      - `usage_limit` number, nullable — Current usage limit.
    - `last_payment_failure` boolean, required — Whether the latest payment attempt failed.
    - `last_payment_failure_protection` boolean, nullable, required — Whether payment failure protection is enabled.
    - `currency` string, required — Currency used for usage and limit amounts.

## Changes

- **2026-08-14** `61436a496404` — 1 warning
  - removed the optional property `limits/completion/usage_limit_organization` from the response with the `200` status
- **2026-07-26** `933c4ebdcd72` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/admin/spend-limit/post.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/61436a496404/schema)