Skip to main content
The migration tool is live as of June 1, 2026 (v2.1.0). Workflows V1 will be removed on September 7, 2026 — see the steps below to migrate.
Workflows V1 is being deprecated in favor of Workflows V2, which introduces a redesigned visual canvas, more trigger types, improved debugging, and version history. Rather than rebuilding your workflows from scratch, the in-platform migration tool lets you migrate existing V1 workflows to V2 in place. For background on the deprecation timeline and what’s changing, see the Workflows V1 Deprecation page.

​
Before You Begin

Migration tool now available

The Migrate Flow tool is live as of June 1, 2026. You can migrate any V1 workflow today — V1 workflows continue to run normally until September 7, 2026.

Plan for downstream updates

After migration, any agents or integrations that call the V1 workflow will need to be updated to point to the new V2 workflow before September 7, 2026, when V1 is removed.

​
How to Migrate a Workflow

After migration, you must run and verify every individual step of the workflow in V2 — not just an end-to-end execution. Per-step verification is the only reliable way to catch subtle behavior differences between V1 and V2 (variable references, trigger payload shape, branching, retries, etc.).
1

Take inventory of your V1 workflows

Go to Workflows and list every V1 workflow that is still in use. Note down:
  • Which workflows are triggered by agents, APIs, or external integrations — these will need downstream updates after migration.
  • The owner of each workflow, so the right person validates it post-migration.
  • A reference output from a recent successful V1 run for each workflow — you’ll compare V2 output against it later.
2

Open a workflow in the V1 builder

Navigate to Workflows and open the workflow you want to migrate. Make sure it is in a stable, working state — migrate published, tested flows first.
3

Click 'Migrate Flow'

In the top-right corner of the V1 builder, click Migrate Flow. This kicks off automated validation against the V2 catalog.
4

Review the migration summary

The migration modal shows a Pass or Fail status along with any errors or warnings.
Workflows that fail validation cannot be self-migrated. Contact your Odin AI account manager or open a ticket through the support portal for assisted migration.
5

Click 'Continue & Import'

This creates the V2 version of your workflow with all actions, triggers, and configuration carried over. The original V1 workflow is not deleted or disabled.
6

Run and verify every step in the V2 workflow

Do not rely on a single end-to-end run. Walk through the workflow step by step:
  1. Open the V2 builder and review the canvas — confirm every action, trigger, branch, loop, and connection from V1 is present.
  2. Verify configuration on each step — credentials, input fields, mapped variables, dropdown selections, and expression references should all match V1.
  3. Run the workflow in test/debug mode with a realistic input payload.
  4. For every step, open the run details and check:
    • Step executed successfully (no error, no skipped state)
    • Input to the step matches what V1 would have sent
    • Output of the step matches the V1 reference output (shape and values)
    • Variable references downstream resolve correctly (no undefined, no {{...}} left unrendered)
    • Branch / loop logic evaluates to the same path as V1
    • Retries, timeouts, and error-handler steps behave as expected
  5. Re-run with edge-case inputs (empty fields, large payloads, failure paths) and repeat the per-step check.
  6. Log any mismatches against the V1 reference output and fix them in the V2 builder before publishing.
Use the V2 Executions log to drill into each step’s input/output JSON. This is the fastest way to spot variable-mapping or schema differences between V1 and V2.
7

Publish the V2 workflow

Only publish once every step has been verified. Click Publish to make the migrated workflow live. V2 keeps full version history, so you can roll back to an earlier version if needed.
The original V1 workflow remains accessible and can continue to run until September 7, 2026, when V1 is removed. You may need to update any agents or integrations that were calling the V1 workflow to point to the new V2 workflow before that date.
8

Update downstream callers

Before September 7, 2026, update anything that calls the V1 workflow to point to the new V2 workflow:
  • Agents that invoke this workflow
  • External integrations using the V1 endpoint or ID
  • Automations and scheduled jobs
9

Monitor the V2 workflow in production

For the first few production runs:
  • Watch the Executions log and spot-check each step’s output against the V1 reference.
  • Keep the V1 workflow live (it remains accessible until September 7, 2026) so you can re-route traffic if a regression appears.
  • Roll back via V2 version history if needed.
10

Repeat for every remaining V1 workflow

Migration is per workflow — there is no bulk action. Work through your inventory from Step 1 until all V1 workflows are migrated, step-verified, and published.

​
Validation: Pass vs. Fail

The migration tool validates your V1 workflow before migrating it. Understanding the validation outcome helps you decide next steps.
Workflows that fail validation cannot be self-migrated. Contact your Odin AI account manager or open a support ticket through the Odin AI support portal for assisted migration.

​
After Migration

Once a workflow is published in V2:
  • The original V1 workflow remains accessible and will continue to run until September 7, 2026, when V1 is removed. Migrating does not disable or delete the V1 workflow.
  • Any agents, integrations, or automations that called the V1 workflow endpoint will need to be reconfigured to call the new V2 workflow before September 7, 2026.
  • Use the Executions log in V2 to monitor runs and verify the migrated workflow behaves as expected.
  • V2 version history saves every published state, so you can roll back to an earlier version if needed.

​
Frequently Asked Questions

No. Migration is triggered per workflow using the Migrate Flow button in the V1 interface. Each workflow must be validated and migrated individually.
The original V1 workflow remains accessible and will continue to run until September 7, 2026. It is not disabled or deleted after migration. On September 7, 2026, all V1 workflows will be removed and any that haven’t been migrated will stop functioning.
Yes. Agents, external integrations, or automation processes that call the V1 workflow by endpoint or ID will need to be updated to point to the new V2 workflow after migration.
Workflows with errors or warnings cannot be self-migrated using the tool. Submit a support ticket through the Odin AI support portal for assisted migration.
The migration tool is designed to carry over your existing workflow configuration to V2. After migration, review all steps, triggers, and settings in the V2 builder and test before publishing.
Workflows V1 will be removed on September 7, 2026. The migration tool is available from June 1, 2026, giving you approximately three months to migrate. V1 workflows will continue to run during this window, but we recommend migrating as early as possible to allow time to update downstream integrations and verify behavior in V2. See the Workflows V1 Deprecation page for the full timeline.

​
Support

For migration assistance or questions about incompatible workflows, contact your Odin AI account manager or open a support ticket through the Odin AI support portal.

Workflows V1 Deprecation

Full deprecation timeline, impact details, and what’s changing.

Workflow Builder V2

Learn what’s new in Workflows V2 and how to build with the updated canvas.