---
title: "Create Rate Limit Override"
method: POST
path: "/internal/rate-limits/overrides"
tags: ["internal"]
---

# Create Rate Limit Override

`POST /internal/rate-limits/overrides`

Create a new rate limit override for an org or user.

This endpoint requires internal API key authentication.

Example request:
```json
{
  "identifier": "org:org_123",
  "endpointLimits": {
    "generation": {
      "maxTokens": 100,
      "refillRatePerSecond": 5.0
    },
    "status": {
      "maxTokens": 200,
      "refillRatePerSecond": 50.0
    }
  },
  "note": "Enterprise plan with higher limits"
}
```

## Headers

- `x-api-key` string, required — Internal API Key for authentication

## Request body

- RateLimitOverrideCreateRequest — Request to create a rate limit override
  - `identifier` string, required — Identifier in format 'org:<id>' or 'user:<id>'
  - `endpointLimits` EndpointLimitsOverride, required — Rate limit overrides for specific endpoints
    - `generation` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
    - `status` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
    - `videoCaptionsSubmit` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
    - `metaTextOverlaySubmit` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
    - `metaTextOverlayPoll` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
  - `note` string — Optional note about why this override exists

## Response `201`

Successful Response

- RateLimitOverrideResponse — Response containing rate limit override information
  - `identifier` string, required
  - `endpointLimits` EndpointLimitsOverride, required — Rate limit overrides for specific endpoints
    - `generation` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
    - `status` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
    - `videoCaptionsSubmit` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
    - `metaTextOverlaySubmit` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
    - `metaTextOverlayPoll` EndpointRateLimitConfig — Rate limit configuration for a specific endpoint
      - `max_tokens` integer, required
      - `refill_rate_per_second` number, required
  - `createdAt` string, date-time, required
  - `createdBy` string, required
  - `updatedAt` string, date-time, nullable
  - `updatedBy` string, nullable
  - `note` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mirage/apis/mirage-video-api.md) · [All operations](https://skmtc.net/mirage/apis/mirage-video-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mirage/mirage-video-api/versions/302cafad9d70/schema)