Skip to content

Migration Guides

Centrali ships breaking changes in major version cuts. Each guide here covers a single hop, with side-by-side before/after for SDK consumers, compute function authors, and raw HTTP users.

Available guides

  • Upgrading to 6.0 — the 5.5.x → 6.0.0 cut (released 2026-05-07). Canonical joins[] schema, typed ${var} parameters, single { data, meta } envelope, removal of api.searchRecords.
  • Query foundation onboarding — the 5.5.1 cut introducing the canonical QueryDefinition. Useful if you're upgrading from a much older 5.x release; otherwise the 6.0 guide subsumes it.

How we deprecate

Centrali never flag-day-removes a public surface. When a route, method, or argument shape is replaced:

  1. The new shape ships first, alongside the old one.
  2. The old shape gets a deprecation telemetry hook (console.warn in SDK, Deprecation + Sunset HTTP headers per RFC 8594).
  3. After the announced sunset date, we delete the old shape in the next major.

If a guide here calls something "sunsetting", that's the deprecation window — your code keeps working, you just have a fixed window to migrate.