Idempotency & rate limits
Auth: Secret API key (rk_sk_)
POST requests accept an optional Idempotency-Key header (UUID). Reusing the same key with a different body within 24 hours returns idempotency_conflict. Rate limits vary by plan.
- Free: 30 req/min · Starter: 120 · Team: 300 · Agency: 600
Header parameters
| Name | Type | Description |
|---|---|---|
Idempotency-Key | string | UUID for safe POST retries (24h window) |
X-RateLimit-Limit | integer | Max requests per minute for your plan (response header) |
X-RateLimit-Remaining | integer | Remaining requests in current window |
X-RateLimit-Reset | integer | Unix timestamp when the window resets |
Responses
429Rate limit exceeded
{
"error": {
"type": "rate_limit_exceeded",
"code": "rate_limit_exceeded",
"message": "Too many requests"
}
}