[ Concepts ]

Rate limits & plans

Understand request throttling and plan availability.

Rate limits per key or connection

  • Free: 30 requests/minute, 1,000/day
  • Pro: 120 requests/minute, 20,000/day

Responses include rate-limit headers. A 429 rate_limited response includes retry_after seconds; wait, then reuse the same idempotency key for a write.

Handling errors

A 429 rate_limited response includes retry_after seconds. Wait, then reuse the same idempotency key for a write.