← All docs

Reference

Errors

Status codes, error bodies, and which ones to retry.

Errors return a JSON body with a stable code, a message for people and a retry flag for code.

Don’t retry

400 for a malformed request, 401 for a missing or revoked key, 413 for a file over the limits, 422 for a schema Tolva can’t read.

Retry with backoff

429 when you are over your rate, and 503 during a deploy. Wait one second, then double the wait each time, up to a minute.

Response · 422

{
  "error": "schema_invalid",
  "message": "properties.due.format must be one of date, date-time",
  "retry": false
}