---
title: "Set Usage Override"
method: PUT
path: "/admin/billing/accounts/{user_id}/usage-override"
tags: ["admin", "billing"]
---

# Set Usage Override

`PUT /admin/billing/accounts/{user_id}/usage-override`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/admin/billing/accounts/{user_id}/usage-override`
- Auth: OAuth 2
  - Password
  - Token URL: `api/login`

## Path parameters

- `user_id` string, required

## Request body

- UsageOverrideUpdate
  - `day_ratio` number
  - `week_ratio` number
  - `limit` UsageLimit: Which limit refuses: the shared meter on one of its windows, or a feature's cap.
    - `feature` 'chat' | 'photo_correction' | 'session_start' | 'library_exercise' | 'copy_review' | 'auto_evaluation' | 'generation' | 'voice' | 'library' | 'recommended_session', required
    - `limit` 'meter' | 'cap', required
    - `window` 'day' | 'week' | 'month', required

## Response `200`

Successful Response

- UsageResponse
  - `applies` boolean, required
  - `warn_at` number, required
  - `day` UsageWindowResponse, required
    - `window` 'day' | 'week' | 'month', required
    - `used_ratio` number, required
    - `resets_at` string, date-time, required
  - `week` UsageWindowResponse, required
    - `window` 'day' | 'week' | 'month', required
    - `used_ratio` number, required
    - `resets_at` string, date-time, required
  - `caps` UsageCapResponse[], required
    - `kind` 'chat' | 'photo_correction' | 'session_start' | 'library_exercise' | 'copy_review' | 'auto_evaluation' | 'generation' | 'voice' | 'library' | 'recommended_session', required
    - `used` integer, required
    - `limit` integer, required
    - `window` 'day' | 'week' | 'month'
    - `resets_at` string, date-time, nullable
    - `blocked` boolean
  - `override` boolean, required

## Other responses

- `404`: Resource not found
- `422`: Validation Error

## Changes

> 106 revisions in range; 1 not diffed.

- **2026-11-12** `0af74c49ba7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/billing/accounts/:user_id/usage-override/put.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/de6afcc9656f?raw)
