Skip to main content

Error catalog

Public Runtime error codes use the stable typed body from the platform error contract (code, message, correlationId, optional details / documentationUrl).

Machine catalog

Download: /artifacts/catalogs/errors.v1.json

Each entry includes code, httpStatus, retryable, and a short English summary. Deep pages at /errors/{code} may be added later; until then this catalog is the SoT for public codes.

Wave 74.15 migration codes

These cross-plane compatibility shutdown codes are not Runtime catalog entries:

CodeSurfaceMeaning and action
license_legacy_compatibility_disabledManagement, HTTP 410The caller still uses generic License create. Move it to Subscription-backed issue; retrying the same route cannot succeed.
relay.host.no_snapshotLocal Relay, validate decision or refresh HTTP 403The Host has no V2 License snapshot authority. Restore a current signed V2 bundle; legacy entitlements, grace, and historical leases cannot bypass the deny.

Follow the Wave 74.15 migration and recovery guide. Do not log the rejected body, License key, or lease token while diagnosing these codes.

Rules

  • code is a stable machine contract (not translated).
  • Do not log license keys, lease tokens, or other secrets in error details.
  • Prefer official SDKs for typed mapping of common codes.

See also OpenAPI and API Reference.