Reference
Rate limits
PromptFloe enforces two layers of limits: per-second API rate limits (to protect the service) and per-day skill quotas (tied to your plan). Both surface in response headers.
#API rate limits (per second)
| Field | Type | Description |
|---|---|---|
| Free | 5 req/s | Per workspace, across all endpoints. |
| Basic | 20 req/s | |
| Pro | 60 req/s | |
| Max | 200 req/s | |
| Enterprise | custom | Negotiated per contract. |
#Daily skill quotas
Critique and augmenter runs each have separate counters. Reset at 00:00 UTC. See Billing for the per-tier table.
#Headers
Every response includes:
| Field | Type | Description |
|---|---|---|
| X-RateLimit-Limit-Requests | number | Per-second API request budget. |
| X-RateLimit-Remaining-Requests | number | Requests left in the current 1s window. |
| X-RateLimit-Reset-Requests | ms | Milliseconds until the window resets. |
| X-RateLimit-Limit-Critique | number | Daily critique-skill cap. |
| X-RateLimit-Remaining-Critique | number | Critique runs left today. |
| X-RateLimit-Limit-Augmenter | number | Daily augmenter cap. |
| X-RateLimit-Remaining-Augmenter | number | Augmenter runs left today. |
| X-RateLimit-Reset-Daily | ISO 8601 | When daily counters reset. |
| Retry-After | seconds | On 429, suggested seconds to wait before retrying. |
#Example 429 response
http
HTTP/1.1 429 Too Many Requests
Retry-After: 2
X-RateLimit-Limit-Requests: 20
X-RateLimit-Remaining-Requests: 0
X-RateLimit-Reset-Requests: 1000
{
"error": {
"code": "rate_limited",
"message": "Per-second rate limit exceeded.",
"retryAfterMs": 2000
}
}#Best practices
- Read the headers — log
X-RateLimit-Remaining-*in your APM. You'll see throttling coming before it hurts. - Honor Retry-After on 429s. The SDK does this automatically.
- Batch where possible — many small calls eat the per-second budget faster than fewer larger ones. Use
listendpoints with appropriatelimitinstead of polling individual ids. - Use webhooks for long-running work instead of polling.
#Where to go next
PromptFloe developer docs