Rate limits

A request over either limit gets 429 request.rateLimited with a Retry-After header: the number of seconds to wait before the next request.

Handling a 429

1. Wait the time you were given

   Read Retry-After and pause that many seconds. Don't retry in a tight loop; every refused request still counts.

2. Spread the work

   Batch reads with limit=100 instead of many small pages, and run background syncs off-peak.

3. Split integrations

   Give each integration its own key, so one busy sync can't use up another's minute. They still share the organization's limit.