code: act on it. It stays stable.message: for people. It can change. Do not parse it.details: more facts for some codes, ornull.requestId: quote it when you write to support.
Codes
Retry safely
Retry only429, 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. Itsstatus 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.