Skip to main content
A failed call returns a non-2xx status and an error object:
code is stable and safe to branch on. message and hint are written for people and may change wording.

Status codes

Retrying writes

Endpoints ending in _update, _upsert or _set write a fixed value, so repeating them is harmless. Endpoints that create something (_create, _add) make a second record if repeated, and destructive endpoints act again. After a 502 or 504 on one of those, read the state back before retrying.