Skip to main content
Every HTTP error has the same shape. Branch on error.code: it is stable and never reworded. error.message is for people and may change.
  • retryable: whether the same request, unchanged, can succeed later.
  • request_id: quote it when you contact support.
  • fault: input (fix the request or add balance) or mindcase (our side).
  • details: extra fields that depend on the code.
Runs that start and then fail are reported on the job, not as HTTP errors. See Jobs and results.

Error codes

Retrying

Retry only when retryable is true, and wait Retry-After (also in details.retry_after_seconds) first. With no wait time, back off exponentially from 0.5 seconds with jitter, up to 30 seconds, and stop after about five attempts. Send an Idempotency-Key on POST .../run so a retry can’t start and charge a second run.