> For the complete documentation index, see [llms.txt](https://oten.gitbook.io/kms-support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oten.gitbook.io/kms-support/user-guide/publish-your-docs-1/api-platform/rate-limit.md).

# Rate limit

Rate limits control how many times a key can call the KMS API in a time period — protecting your workspace from runaway loops, cost spikes, and one application consuming all the quota.

<div align="left" data-with-frame="true"><figure><img src="/files/HoZbnqnFX6RCD9LnzDh4" alt="" width="563"><figcaption></figcaption></figure></div>

| Window                        | What it controls?                                        |
| ----------------------------- | -------------------------------------------------------- |
| **RPM** — Requests per Minute | Short bursts. E.g., max 60 calls in any 60-second window |
| **RPH** — Requests per Hour   | Sustained load. E.g., max 1,000 calls per hour           |
| **RPD** — Requests per Day    | Daily ceiling. E.g., max 10,000 calls per day            |

### **Rate Limit Inheritance**

&#x20;             **Global Default Policy**  <- set by Org Admin (all workspaces)

&#x20;                             **↓**

&#x20;             **Workspace Global Setting**      <- set by Org Admin (per workspace)

&#x20;                             **↓**

&#x20;             **Per-key Rate Limit**     <- set by you (Workspace Admin)

* No Workspace Global Setting: keys follow the **Global Default Policy**
* Workspace Global Setting exists: keys are bound to that **Workspace Global Setting**
* Keys with a manual limit are **not affected** when Org Admin changes the global policy

**In short:** your Org Admin sets the ceiling. You work within it.

### **When a key gets throttled**

Your application receives a rate limit error and should retry after a short wait. In Oten KMS, the key status changes to **Throttling** and the event is recorded in the History Log. Check which window (RPM/RPH/RPD) is exceeded, wait for the reset, or contact your Org Admin for a higher ceiling.

<br>