Skip to main content
Fluz applies fair-use rate limits on the transactional graph and the OAuth service. Limits are tuned to typical integration patterns; contact your account team if your production workload needs headroom.

When you’re throttled

Rate-limited requests return an HTTP 429 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

  1. Ask for less. Trim your selection set to the fields you actually use.
  2. Batch reads. One query that returns 100 items costs less than 100 queries returning one each.
  3. Use webhooks instead of polling. See Configure App Widget for webhook setup.
  4. Retry with exponential backoff and jitter — never in a tight loop.
  5. Refresh access tokens ahead of expiry to avoid 401 → mint-token → retry cycles under load.