429 TOO MANY REQUESTS response.
All API responses include the following headers so you can monitor and manage your request rate:
integer
Maximum number of requests allowed per minute.Example:
60integer
Number of requests remaining in the current rate limit window.Example:
58integer
Unix timestamp when the rate limit window resets.Example:
1783470988File upload size limits
File uploads are limited to a maximum size of 256 MB. Requests exceeding this limit return a413 PAYLOAD TOO LARGE response.
Retry recommendations
Implement retry logic for429 and 503 errors using an exponential backoff strategy with randomised jitter to avoid overwhelming the server.
Example retry strategy:
- Receive a
429or503error. - Read the
Retry-Afterheader value (seconds). - Wait for the specified duration plus a random jitter (0-5 seconds).
- Retry the request.
- If the request fails again, double the wait time and repeat.