Skip to main content
Every error has the same shape:
  • code: act on it. It stays stable.
  • message: for people. It can change. Do not parse it.
  • details: more facts for some codes, or null.
  • requestId: quote it when you write to support.

Codes

Retry safely

Retry only 429, 500, 503 and network errors. Wait longer each time, for example 1, 2, 4, 8 and 16 seconds. A POST /v1/tasks that timed out may have created the task. Always send an Idempotency-Key on it. A retry with the same key and body then returns the first task, and charges once. See Retry safely. A GET is always safe to retry.

A task that fails

A task can fail after it was created. Its status is then failed, error has a code and a message, and a live task is refunded. A failed task does not run again. To try again, create a new task.