Skip to main content
Narrative SDK normally uses a three-part version number: major, minor and patch. v1.9.0 and v1.9.1 have the compatibility exceptions described below.

Current release line

  • Active release line: v1.9
  • Latest published version in this line: v1.9.1

Compatibility commitments

  • Releases at the patch position (for example, 1.8.2 to 1.8.3) can include fixes, quality improvements and new capabilities. Existing integrations keep working without changes unless a release declares a compatibility exception.
  • Minor releases (for example, 1.5.x to 1.8) can add capabilities while remaining backwards compatible.
  • Major releases (for example, 1.x to 2.0.0) may include breaking changes.

v1.9.0 compatibility exception

v1.9.0 is an exception to the backwards-compatible minor-release commitment. The version number remains v1.9.0; its release notes are labelled Major because some existing integrations need changes to keep working. Users must sign in again after upgrading. Partner integrations that manage Narrative user accounts or branding need an update for v1.9.0. Read the v1.9.0 release notes for compatibility and upgrade guidance.

v1.9.1 compatibility exception

v1.9.1 is an exception to the backwards-compatible patch-release commitment. The version number remains v1.9.1; its release notes are labelled Major because custom API integrations need report-access and request-handling updates. The hosted Narrative app handles the updated contracts. Custom clients must authenticate report retrieval, handle Chat validation responses and supply business background explicitly when updating Money Project inputs. Read the v1.9.1 compatibility guidance for the required integration changes.

What is considered a breaking change

A change is treated as breaking if an existing integration must be updated to keep working, for example:
  • removing a capability that an integration relies on
  • changing how an integration exchanges information with Narrative
  • changing how users sign in or access their workspace

Release notes commitment

Each published version includes release notes that summarise user-facing changes and any migration impact. For any release that introduces breaking changes, migration guidance is provided in the associated release notes.