Limits
Rate Limits
The default public API limiter allows 10 requests per minute per API key or caller fingerprint. Deployments can tune this value with environment configuration.
Limits4 min
Public API GatewaySee where throttling fits into the gateway responsibilities.Error CodesReview the
429 rate_limit_exceeded response shape.Default
10 req/min
Per API key or caller fingerprint unless configured otherwise.
Scope
Gateway
Applied before expensive PDF work is queued.
Retry
Backoff
Use exponential backoff and preserve idempotency on safe retries.
Section
Limit Behavior
Section
Rate Limit Error
429 error
json
{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Please retry later.",
"type": "rate_limit_error",
"request_id": "req_01JX8Y62XCDNZ2BM7TBM2M9Q8E"
}
}Section
Client Behavior
- Queue work on your side when submitting many files.
- Use exponential backoff for
429and transient service errors. - Use
Idempotency-Keyfor submit retries so a timeout does not create duplicate jobs. - Poll status at a practical interval instead of tight loops.