Rate Limits & Errors

{
  "success": false,
  "statusCode": 429,
  "message": "Too many requests",
  "data": { "hint": "Rate limit exceeded. Retry after a short delay." }
}

async function withRetry(fn, attempts = 5) {
  for (let i = 0; i < attempts; i++) {
    const res = await fn();
    if (res.statusCode !== 429) return res;

    const wait = Math.min(2 ** i * 250, 8000) + Math.random() * 250;
    await new Promise((r) => setTimeout(r, wait));
  }
  throw new Error("Rate limited after 5 attempts");
}

{
  "success": false,
  "statusCode": 426,
  "message": "ai_tokens limit exceeded (used: 10020, limit: 10000)",
  "data": { "used": 10020, "limit": 10000, "remaining": 0, "overflow": 20 }
}

// JavaScript
const res = await cms.article.create(payload);

if (!res.ok) {
  if (res.error.status === 429) return scheduleRetry();
  if (res.error.status === 426) throw new Error("Quota reached — pausing the job");
  throw new Error(`${res.error.status}: ${res.error.message}`);
}