Rate limiting

The Ybug API limits each authenticated client to 100 requests per minute (RPM). Requests beyond the limit return 429 Too Many Requests.

Handling 429 responses

When you hit the limit, back off and retry. A simple exponential backoff (e.g. 1s → 2s → 4s → 8s) is usually sufficient.

# pseudocode
attempt = 0
while true:
  response = call_api()
  if response.status != 429:
    break
  sleep(min(2 ** attempt, 30))
  attempt += 1

Tips for staying under the limit

• Cache responses for data that changes infrequently (teams, projects).
• Use webhooks — see the Hooks group in the sidebar — to react to feedback events instead of polling list endpoints.
• Increase page_size (up to 100) when bulk-loading data so you fetch more items per request. See Pagination.