Skip to content

Rate Limits

The API rate-limits globally (on the order of 1,200 requests per minute under default configuration), bucketed by client identity — authenticated callers get their own budget rather than sharing one IP pool.

  • Poll rarely. Dashboards refreshing every second per server will eat the budget and get throttled. Prefer 10–30 s intervals, and use event streams for live data instead of polling (streams are long-lived and not counted like REST calls).
  • Back off on 429. The response carries code RATE_LIMITED with X-RateLimit-* headers (and Retry-After where offered); honor them, then retry with exponential backoff.
  • Batch and cache. Fetch lists once and derive views client-side; cache slow-moving data (templates, nests, permissions catalog).
  1. Reduce poll frequency and parallel fan-out first.
  2. Move live views to event streams.
  3. Talk to the panel administrator — limits are operator-configured, and a legitimate integration with a sensible pattern can get headroom.