Rate limits

Limits by plan

How the limit is counted

• Per workspace, not per key. Creating more keys does not raise the limit.
• Per calendar minute. The count resets at the start of every minute (UTC), not on a sliding window.
• Every authenticated request counts, including ones that end in 404 or 500. Requests refused with 401 or 402 are rejected before the limiter and do not count.
• The count is atomic in the database, so parallel requests cannot slip past it. With a limit of 60, the 61st request in a minute is refused however many arrive at once.

Response headers

Every response to an authenticated request carries the current state:

When you hit the limit

The API answers 429 with the error code rate_limited. Wait the number of seconds in Retry-After, then retry.

async function getWithRetry(url, init, attempts = 3) {
  for (let i = 0; i < attempts; i++) {
    const res = await fetch(url, init);
    if (res.status !== 429) return res;
    const wait = Number(res.headers.get("Retry-After") ?? "1");
    await new Promise((r) => setTimeout(r, wait * 1000));
  }
  throw new Error("Still rate limited after retries");
}

import time
import requests

def get_with_retry(url, headers, attempts=3):
    for _ in range(attempts):
        res = requests.get(url, headers=headers, timeout=30)
        if res.status_code != 429:
            return res
        time.sleep(int(res.headers.get("Retry-After", "1")))
    raise RuntimeError("Still rate limited after retries")