Documentation Index
Fetch the complete documentation index at: https://docs.arcmira.com/llms.txt
Use this file to discover all available pages before exploring further.
Every Arcmira API key is rate limited per minute. Limits are tier-based but can be overridden on individual keys for enterprise use cases.
Default limits
| Plan tier | Requests per minute |
|---|
| Free | 60 |
| Paid (Pro, Pro+) | 240 |
| Teams / Enterprise | 600 |
| Header | Description |
|---|
RateLimit-Limit | Requests allowed per minute for this key. |
RateLimit-Remaining | Requests left in the current 60-second window. |
RateLimit-Reset | Unix epoch (seconds) when the current window resets. |
| Header | Description |
|---|
Retry-After | Seconds to wait before the next attempt. Always honor it. |
Error shape on throttle
{
"error": {
"type": "rate_limit_error",
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Try again after 1747200120.",
"doc_url": "https://docs.arcmira.com/errors#rate_limit_exceeded",
"request_id": "req_..."
}
}
429.
Practical backoff
async function callWithBackoff(url, init, maxRetries = 5) {
let attempt = 0;
while (true) {
const res = await fetch(url, init);
if (res.status !== 429) return res;
const retry = Number(res.headers.get('Retry-After') || '1');
if (attempt++ >= maxRetries) return res;
await new Promise((r) => setTimeout(r, retry * 1000));
}
}
import asyncio, httpx
async def call_with_backoff(client, method, url, max_retries=5, **kw):
for attempt in range(max_retries + 1):
r = await client.request(method, url, **kw)
if r.status_code != 429:
return r
if attempt == max_retries:
return r
await asyncio.sleep(int(r.headers.get('retry-after', '1')))
Capacity-side errors
Throttling is different from monthly quota exhaustion. If your included rows are gone and on-demand usage is off, you’ll see 402 quota_exceeded instead of 429. See Usage & billing.
