When you’re throttled
Rate-limited requests return an HTTP429 on the transport, or a rate-limit error code inside the GraphQL errors array. Back off before retrying and add jitter to smooth bursts.
Best practices
- Ask for less. Trim your selection set to the fields you actually use.
- Batch reads. One query that returns 100 items costs less than 100 queries returning one each.
- Use webhooks instead of polling. See Configure App Widget for webhook setup.
- Retry with exponential backoff and jitter — never in a tight loop.
- Refresh access tokens ahead of expiry to avoid 401 → mint-token → retry cycles under load.