Skip to main content
Workflow versions represent specific configurations of a workflow’s task graph. Each version defines the tasks, their dependencies, and the execution order. You create new versions when the workflow logic changes, and you can list, filter, and retrieve versions for a given workflow.

​
Overview

A workflow version is the executable definition of a workflow. It contains the full task graph: which tasks run, in what order, and how they depend on each other. When you trigger a workflow, you specify which version to run.

​
Version structure

Each workflow version includes:
  • Tasks – The individual steps in the workflow
  • Dependencies – Which tasks run after which (the execution graph)
  • Configuration – Task-specific parameters and settings
  • Conditional logic – Optional branching based on task outcomes

​
Creating versions

You create a new workflow version by defining the task graph for a workflow. The version receives a unique identifier and becomes the latest version of that workflow unless you create another. You can reference a specific version when creating triggers or starting executions manually.
Once created, a workflow version cannot be modified. To change the logic, create a new version and update your triggers to use it.

​
Listing and filtering

You can list all versions for a workflow, optionally filtering by status or creation time. Use this to find the correct version to run or to audit workflow changes over time.
Last modified on April 23, 2026