Rate Limits

FlowStack enforces rate limits to ensure fair usage and platform stability.

Limits by Plan

Plan	API Requests	Webhook Triggers	Flow Executions
Free	100/hour	50/hour	1,000/month
Pro	1,000/hour	500/hour	10,000/month
Team	5,000/hour	2,500/hour	50,000/month
Enterprise	Custom	Custom	Custom

Rate Limit Headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1714300800

Header	Description
X-RateLimit-Limit	Maximum requests allowed in the current window
X-RateLimit-Remaining	Requests remaining in the current window
X-RateLimit-Reset	Unix timestamp when the rate limit resets

Exceeding the Limit

When you exceed the rate limit, the API returns:

HTTP/1.1 429 Too Many Requests
Retry-After: 45

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 45 seconds.",
    "statusCode": 429
  }
}

Best Practices

• Use pagination — Fetch data in pages instead of requesting all records at once
• Cache responses — Cache list data locally and refresh periodically
• Implement exponential backoff — When rate limited, wait and retry with increasing delays
• Use webhooks — Instead of polling for changes, set up webhooks to receive real-time notifications
• Batch operations — Group related operations to minimize API calls

Requesting Higher Limits

Contact support@onflowstack.com or upgrade your plan at Settings → Billing for higher rate limits.