Skip to main content

Error codes

Vluna uses stable machine-readable error codes for programmatic handling and support.

Source of truth​

Error code definitions live in:

  • packages/contracts/error-codes.json

How to use error codes​

In your integration:

  • Branch on code, not on message.
  • Treat messages as user-facing or operator-facing text only.
  • Log the full envelope and X-Request-Id when present.

Use the code metadata to drive retry decisions where available:

  • never retry validation failures
  • retry transient failures with backoff
  • retry write timeouts via idempotency replays