Skip to main content

​
Versioning policy

Narrative SDK follows semantic versioning (MAJOR.MINOR.PATCH) for public releases.

​
Current release line

  • Active release line: v1.5
  • Latest published version in this line: v1.5.12

​
Compatibility commitments

  • Releases at the patch position (for example, 1.5.1 to 1.5.12) can include fixes, quality improvements, and new capabilities. They do not introduce breaking API contract changes.
  • Minor releases (for example, 1.5.x to 1.6.0) can add capabilities while remaining backwards compatible.
  • Major releases (for example, 1.x to 2.0.0) may include breaking 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 or renaming public endpoints or fields
  • changing request or response formats in an incompatible way
  • changing authentication or authorisation requirements for existing endpoints

​
Release notes commitment

Each published version includes release notes that summarise user-facing changes and any migration impact. If a breaking change is introduced in a future major version, migration guidance is provided in the associated release notes.