Failure Modes

Read

A gateway connection failure returns an error to the client. SDKs do not retry directly against the backing store. Check /health, gateway logs, and connectivity to the configured database or upstream service.

A backing-store failure fails the request. Unsupported request shapes return 422 UnsupportedByStore. Use the store matrix to choose a supported operation.

Write

Success requires the backing-store write to succeed. An invalid nonblank Turbopuffer key fails against Turbopuffer; it does not select local Postgres. Use an explicitly blank key for the local quickstart.

Client failures

Check the base URL, authentication settings, and error body. Retrying a timed-out write may repeat a request that reached the store; use stable row IDs and the store’s write semantics when designing retries.

See health and metrics for gateway diagnostics.