Skip to main content

Rate Limits and Errors

Rate Limiting​

API requests are subject to middleware-based rate limiting.

When limits are exceeded, clients should:

  1. Back off with retry delay.
  2. Avoid concurrent burst retries.
  3. Use idempotent request patterns for retried writes.

Error Format​

Most failures return JSON payloads with error and/or message fields.

Typical status codes:

  • 400 invalid input
  • 401 unauthorized
  • 404 not found
  • 409 conflict
  • 429 rate-limited
  • 500 internal server error