Rate limits

Each API key gets its own token bucket. The bucket refills at the configured per-minute rate (default 60); requests over that rate get 429 Too Many Requests with a Retry-After header indicating seconds until the next token.

Error shape

HTTP 429

{
  "error": {
    "type": "rate_limit_exceeded",
    "message": "rate limit exceeded; retry in 3s"
  }
}

Tuning

The default per-minute rate is set globally via the SABLE_RATE_LIMIT_PER_MIN environment variable on the gateway.

You can also override it per key. Pass rate_limit_per_min when you mint a key (see API key controls) and that key gets its own bucket; leave it off and the key uses the global default. Handy for giving a high-throughput agent more headroom, or boxing a noisy one in.