Errors

All errors follow a standard format:

JSON

Error Types

StatusTypeSDK ExceptionDescription
400invalid_request_errorAPIErrorInvalid request
401authentication_errorAuthenticationErrorInvalid or missing API key
404not_foundNotFoundErrorResource not found
409conflict_errorAPIErrorResource conflict (duplicate, not active)
422validation_errorValidationErrorInvalid request parameters
429rate_limit_errorRateLimitErrorToo many requests (auto-retried for GET/PUT/DELETE)
500+api_errorAPIErrorServer error (auto-retried for GET/PUT/DELETE)

Automatic Retries

The Python SDK automatically retries 429 (rate limit) and 500+ (server error) responses with exponential backoff for idempotent methods (GET, PUT, DELETE). POST and PATCH are not retried to prevent duplicate side effects.

Handling Errors

Python