Back to Help

api

Errors and Rate Limits

Handle API failures, rate limits, and retry strategies safely.

Audience: developer

Error Shape

API errors return an error object with fields like:

  • type
  • code
  • message
  • request_id (when available)

Common Status Codes

  • 400 invalid request payload
  • 401 authentication required/invalid credentials
  • 403 tier gating or authorization failure
  • 404 resource not found
  • 409 idempotency conflict
  • 429 rate limited

Retry Strategy

  1. Retry transient 5xx errors with exponential backoff.
  2. Respect Retry-After on 429 responses.
  3. Use idempotency-key on write endpoints.
  4. Log request IDs for troubleshooting.

Tier Notes

If you receive 403 with a tier-related code/message, the account likely needs Pro or Max for API access.