Rate limits

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Slow down and retry after the indicated delay."
  },
  "request_id": "req_8a1f2c3d4e5f"
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "quota_exceeded",
    "message": "Monthly generation quota exhausted. Quota resets on a rolling 30-day window."
  },
  "request_id": "req_9b2e3d4c5f60"
}

# curl honors Retry-After only if you script it; this loop reads the
# header and sleeps before retrying on a 429.
url="https://justflow.it/api/v1/diagrams"
for attempt in 1 2 3 4 5; do
  resp=$(curl -sS -D /tmp/h -o /tmp/b -w "%{http_code}" \
    -H "Authorization: Bearer jfi_sk_live_..." "$url")
  if [ "$resp" != "429" ]; then cat /tmp/b; break; fi
  retry=$(grep -i '^Retry-After:' /tmp/h | tr -d '\r' | awk '{print $2}')
  echo "429 received; sleeping ${retry:-2}s (attempt $attempt)"
  sleep "${retry:-2}"
done

async function requestWithBackoff(url, init, maxAttempts = 5) {
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const res = await fetch(url, init);

    if (res.status !== 429) return res;

    const body = await res.json();
    // Hard stop: quota will not free up by retrying now.
    if (body?.error?.code === "quota_exceeded") {
      throw new Error(`quota_exceeded (request_id=${body.request_id})`);
    }

    // Transient: honor Retry-After, then exponential backoff with jitter.
    const retryAfter = Number(res.headers.get("Retry-After")) || 1;
    const backoff = retryAfter * Math.pow(2, attempt) * 1000;
    const jitter = Math.random() * 250;
    await new Promise((r) => setTimeout(r, backoff + jitter));
  }
  throw new Error("rate_limit_exceeded: max attempts reached");
}

const res = await requestWithBackoff("https://justflow.it/api/v1/diagrams", {
  headers: { Authorization: "Bearer jfi_sk_live_..." },
});

import time, random, requests

def request_with_backoff(url, headers, max_attempts=5):
    for attempt in range(max_attempts):
        res = requests.get(url, headers=headers)

        if res.status_code != 429:
            return res

        body = res.json()
        # Hard stop: retrying won't free quota in this window.
        if body.get("error", {}).get("code") == "quota_exceeded":
            raise RuntimeError(f"quota_exceeded (request_id={body['request_id']})")

        # Transient: honor Retry-After, then exponential backoff + jitter.
        retry_after = int(res.headers.get("Retry-After", "1"))
        backoff = retry_after * (2 ** attempt)
        time.sleep(backoff + random.uniform(0, 0.25))

    raise RuntimeError("rate_limit_exceeded: max attempts reached")

res = request_with_backoff(
    "https://justflow.it/api/v1/diagrams",
    headers={"Authorization": "Bearer jfi_sk_live_..."},
)