Skip to content

Errors

Direct HTTP integrations receive standard status codes plus SkyState error bodies where applicable. The JavaScript SDKs translate these into SkyStateError values, subsystem status snapshots, and React onError callbacks depending on where the error occurs.

Common situations that result in errors:

  • Route target not found - the project, environment, or account route identifier is not recognized
  • No state yet - public-state and user-state reads can return 204; SDK keyed reads continue to use their fallback value
  • Quota exceeded - the account's monthly API-request quota or another tier limit has been reached; see Rate Limiting
  • Authentication failure - the API key is invalid or has been revoked; see Dev API Keys
  • Version conflict - a write used an outdated If-Match version and returned 412
  • Quota failure - a write would exceed a tier limit, such as the Stored Users limit for user state

For SDK-specific error handling, see the SDK docs.