Rate limits

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1715900400
X-Request-Id: req_abc

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1715900412

{
  "error": {
    "type": "rate_limited",
    "code": "rate_limited",
    "message": "Rate limit exceeded for this API key (300 rpm)",
    "request_id": "req_abc"
  }
}

async function withRateLimitBackoff<T>(fn: () => Promise<T>): Promise<T> {
  while (true) {
    try {
      return await fn();
    } catch (err) {
      if (err.status !== 429) throw err;
      const retryAfter = Number(err.headers?.['retry-after'] ?? 1);
      await new Promise((r) => setTimeout(r, retryAfter * 1000));
    }
  }
}

HTTP/1.1 429 Too Many Requests
Retry-After: 1800
X-Request-Id: req_xyz

{
  "error": {
    "type": "rate_limited",
    "code": "anomaly_paused",
    "message": "Org temporarily paused due to spending anomaly. Resumes at 2026-05-19T16:30:00Z."
  }
}