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.
Stay friendly
Section titled “Stay friendly”- 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_LIMITEDwithX-RateLimit-*headers (andRetry-Afterwhere 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).
If you are limited during normal use
Section titled “If you are limited during normal use”- Reduce poll frequency and parallel fan-out first.
- Move live views to event streams.
- Talk to the panel administrator — limits are operator-configured, and a legitimate integration with a sensible pattern can get headroom.
