Errors

A failure is an RFC 9457 problem (application/problem+json): type (an anchor below), title, status, detail, and the service's code and context.

not_found 404

Nothing matches the reference given, or the path answers no operation.

method_not_allowed 405

The path answers other methods, which the Allow header lists.

not_entitled 403

The resource exists but is held back from this caller.

not_permitted 401, 403 or 429

context.reason says why: credential (401: send the token when it is missing, else create a new one, as it is expired, revoked or used on a channel it is not bound to), scope (403, the token lacks the scope), principal (403, the token may not act on this store or row, or a file capability was minted for another token), plan (403, the plan does not include it), paused (403, the business has been past a limit of its plan for 7 days, or its payment has been failing for 7 days, so it grants nothing new until it is back within its limits or pays), suspended (403, the business is suspended: only billing, deleting stores and the business, removals and reads go on until it chooses a plan or is back within its limits), limit (429, see the limits guide).

conflict 409

The call clashes with the current state. context names the field, its current value and what it is blocked_by, and for a from, live, expect or version that no longer matches, the argument (path) and what it takes there (reason).

invalid 422

An argument is malformed. context.path points at it (["body"] for the body itself, ["headers", "idempotency-key"] for the key, ["query", "access_token"] for a token in a file's URL, which is never taken) and context.reason says what is wrong; a rich text field outside the format is refused this way too, quoting the text around where it stopped (see the rich text guide). A body over 16 MiB answers 413 with this type; one nesting deeper than 64 levels, or holding more than 100000 objects and arrays or 100000 values, answers 422.

range_not_satisfiable 416

A file was asked for with a Range outside it, or other than one bytes range. Content-Range: bytes */{length} gives the length of what it serves; ask again for one range within it.

internal 500

The call failed inside the service. A read, or a write sent with an Idempotency-Key, may be retried with backoff and a bounded number of attempts; any other write may have landed, so read the state back first.

unavailable 503

The service could not be reached. Retry as for internal.

client-fault 500

The API itself failed before or after calling the service, and retrying will not help. reached_core says whether the call reached the service; when it did, core_answer is what the service answered: ok means the write landed, a code means it was refused, internal leaves the outcome unknown.

No answer carries Retry-After unless the service said when to retry.