Skip to main content

Error Handling

The API returns standard HTTP status codes to indicate success or failure of requests.

Error Response Format

Common Error Codes

StatusError TypeDescription
400Bad RequestInvalid request parameters
401UnauthorizedMissing or invalid authentication
403ForbiddenInsufficient permissions
404Not FoundResource does not exist
422Validation ErrorRequest validation failed
429Rate LimitedToo many requests
500Server ErrorInternal server error

SDK Error Handling

Retry Strategy

For transient errors (429, 5xx), we recommend implementing exponential backoff:
  1. Wait 1 second, then retry
  2. If still failing, wait 2 seconds, then retry
  3. If still failing, wait 4 seconds, then retry
  4. Maximum of 3 retries
The SDKs implement automatic retry with exponential backoff for transient errors.