> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nalhajery.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Override

> Create a client-specific rate limit override (admin only)

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer <admin_token>`
</ParamField>

## Request Body

<ParamField body="client_id" type="string" required>
  The client's profile ID (UUID)
</ParamField>

<ParamField body="allowed_limit" type="integer" required>
  Custom request limit
</ParamField>

<ParamField body="window_seconds" type="integer" required>
  Custom time window
</ParamField>

<ParamField body="is_active" type="boolean" default="true">
  Whether this override is active
</ParamField>

### Example Request

```bash theme={null}
curl -X POST https://api.sari-platform.com/api/rate-limits/overrides \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "550e8400-e29b-41d4-a716-446655440000",
    "allowed_limit": 5000,
    "window_seconds": 3600,
    "is_active": true
  }'
```

## Response

```json theme={null}
{
  "id": 1,
  "client_id": "550e8400-e29b-41d4-a716-446655440000",
  "allowed_limit": 5000,
  "window_seconds": 3600,
  "is_active": true,
  "created_at": "2024-01-15T10:00:00Z"
}
```

<Note>
  Overrides take precedence over tier-based limits. A client can have only one active override.
</Note>

## Errors

| Status | Description                           |
| ------ | ------------------------------------- |
| 400    | Invalid request body                  |
| 401    | Invalid or expired token              |
| 403    | Admin access required                 |
| 404    | Client not found                      |
| 409    | Client already has an active override |
