Handling Errors

Error format

{
  "request_id": "...",
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

Retryable errors

Retry with backoff when you see:

• rate_limited
• concurrency_limit_reached
• timeout_error
• temporary_unavailable
• internal_error

Non-retryable errors

Fix the request when you see:

• invalid_request
• invalid_url
• access_key_invalid
• ssrf_blocked

Log request ids

Include the request_id in logs and support requests.

Idempotency

Use Idempotency-Key for safe retries of POST requests.