Skip to content

temporal

v1.32.2
temporalio/temporal

Temporal service

Version of temporalio/temporal you run

CompareView on GitHub

Breaking changes

What to check before upgrading, taken from the notes of the last 30 releases.

  • v1.32.2Nov 2, 2026

    Potential Breaking Change

    • ValidateWorkerDeploymentVersionComputeConfig now requires Write access to the namespace. The API has persistent side-effects inconsistent with read-only access, so this requirement is aligned with the API bahavior. Please refer to https://github.com/temporalio/temporal/pull/12843 for details.

    Full Changelog: https://github.com/temporalio/temporal/compare/v1.32.1...v1.32.2

  • v1.31.5Nov 2, 2026

    Potential Breaking Change

    • ValidateWorkerDeploymentVersionComputeConfig now requires Write access to the namespace. The API has persistent side-effects inconsistent with read-only access, so this requirement is aligned with the API bahavior. Please refer to https://github.com/temporalio/temporal/pull/12843 for details.

    Full Changelog: https://github.com/temporalio/temporal/compare/v1.31.4...v1.31.5

  • v1.32.0Sep 11, 2026
    • ### ⚠️ Behavioral and Configuration Changes
    • ### ⚠️ Behavioral and Configuration Changes

    ⚠️💥 Final release before removal of deprecated Worker Versioning

    Correction to the v1.31 release notes: v1.32 is the final release containing the deprecated Worker Versioning implementations. Complete removal is now planned for server v1.33, rather than v1.32.

    The following deprecated APIs are planned for removal in v1.33:

    • UpdateWorkerBuildIdCompatibility
    • GetWorkerBuildIdCompatibility
    • UpdateWorkerVersioningRules
    • GetWorkerVersioningRules
    • GetWorkerTaskReachability
    • SetCurrentDeployment
    • GetCurrentDeployment
    • DescribeDeployment
    • ListDeployments
    • GetDeploymentReachability

    The Build ID Compatibility and Versioning Rules management APIs remain disabled by default in v1.32. Existing legacy routing information and workflow-progress behavior remain available so operators can complete their migration. The deprecated pre-release Deployment APIs already return Unimplemented.

    Before upgrading to v1.33, migrate to the current Worker Deployment APIs and drain or complete every running, sleeping, or backlogged Workflow that still depends on a legacy Build ID, compatible Version Set, Assignment Rule, Redirect Rule, or deprecated Deployment routing state.

    Rolling back to v1.32 should be treated as emergency recovery for a missed legacy Workflow, not as a migration strategy.

    • ### ⚠️ Behavioral and Configuration Changes
    • ## ⚠️ Behavioral Changes
    • ## ⚠️ Behavioral and Configuration Changes
    • ## ⚠️ Behavioral and Configuration Changes
    • ## ⚠️ Behavioral and Configuration Changes
    • 💥 Nexus callbacks now route by URL scheme by default: worker targets always use temporal://system, while legacy Nexus-Callback-Source header-based routing is available only when callback.inspectSourceHeader is enabled. The obsolete nexusoperation.useSystemCallbackURL and component.nexusoperations.useSystemCallbackURL settings have been removed.
  • v1.30.6Jul 8, 2026

    Potential Breaking Change

    If using authorization with replication setup, set system.disableStreamingAuthorizer dynamic config to true to opt out from changes in this release and avoid replication traffic connection errors. Check the linked CVE for implications of opting out.

  • v1.31.2Jul 8, 2026

    Potential Breaking Change

    If using authorization with replication setup, set system.disableStreamingAuthorizer dynamic config to true to opt out from changes in this release and avoid replication traffic connection errors. Check the linked CVE for implications of opting out.

  • v1.31.0Apr 29, 2026
    • ### 💥 Overhaul Nexus error model
    • ### ⚠️💥 Sunsetting Worker Versioning V1 (Version Sets) and V2 (Assignment Rules)

    APIs to be removed in v1.32.0:

    • ~~UpdateWorkerBuildIdCompatibility~~
    • ~~GetWorkerBuildIdCompatibility~~
    • ~~UpdateWorkerVersioningRules~~
    • ~~GetWorkerVersioningRules~~
    • ~~GetWorkerTaskReachability~~
  • v1.28.4Apr 10, 2026

    Potential Breaking Change

    If using authorization with replication setup, set system.disableStreamingAuthorizer dynamic config to true to opt out from changes in this release and avoid replication traffic connection errors. Check the linked CVE for implications of opting out.

  • v1.29.6Apr 10, 2026

    Potential Breaking Change

    If using authorization with replication setup, set system.disableStreamingAuthorizer dynamic config to true to opt out from changes in this release and avoid replication traffic connection errors. Check the linked CVE for implications of opting out.

Release history

All releases on GitHub
BadgeLatest version of temporalio/temporal[![version](/badge/temporalio/temporal)](/p/temporalio/temporal)

What's Changed

Potential Breaking Change

  • ValidateWorkerDeploymentVersionComputeConfig now requires Write access to the namespace. The API has persistent side-effects inconsistent with read-only access, so this requirement is aligned with the API bahavior. Please refer to https://github.com/temporalio/temporal/pull/12843 for details.

Full Changelog: https://github.com/temporalio/temporal/compare/v1.32.1...v1.32.2

Full release notesCompare with previous