Temporal CLI applies one-time move versioning overrides
Introduced 2026-09-14 · score 0.97
HOW TO USE IT
When moving a Workflow to a Worker Deployment Version for one Workflow Task, run `temporal workflow update-options` with `one_time` behavior and the target Deployment Name and Build ID.
temporal workflow update-options --workflow-id <workflow-id> --versioning-override-behavior one_time --versioning-override-deployment-name <deployment-name> --versioning-override-build-id <build-id>WHY THIS HELPS
Apply a one-time move versioning override from a coding or development workflow.
REQUIREMENTS AND LIMITATIONS
- Version: v1.9.1
- --workflow-id, -w (required): Workflow ID; use this or `--query`.
- --query, -q (required): SQL-like List Filter for batch operations; use this or `--workflow-id`.
- --versioning-override-behavior (required): Override behavior; accepted values are `unspecified`, `pinned`, `one_time`, and `auto_upgrade`.
- --versioning-override-deployment-name: Target Deployment Name when behavior is `pinned` or `one_time`.
- --versioning-override-build-id: Target Build ID when behavior is `pinned` or `one_time`.
- Prerequisite: Use Temporal CLI v1.9.1 or later for the CLI capability introduced in this release.
FIRST-PARTY EVIDENCE
- https://github.com/temporalio/cli/releases/tag/v1.9.1
- https://github.com/temporalio/documentation/blob/main/docs/cli/command-reference/workflow.mdx
Check the installed version and the source before using it. Entry JSON