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.

Write

Success requires the backing-store write to succeed. An invalid Turbopuffer key fails against Turbopuffer.

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.