Error Handling

Use these status codes and retry patterns to troubleshoot failed requests quickly.

Common status codes

• 400: invalid request parameters or body
• 401: authentication failed (missing/invalid API key)
• 403: request blocked by account/tier policy
• 404: requested resource/job/model not found
• 502: upstream or evaluation sample failure
• 503: temporary backend unavailability

Retry guidance

• retry 503 with backoff
• do not retry malformed 400 requests without fixing input
• for polling endpoints, use a fixed 3-10 second interval