Deploy Workflows

A deployment is a published version of a workflow that outside callers can run. While you build, a workflow lives on your canvas as a draft you can run from the editor. Deploying publishes a fixed copy of that draft and gives it an address: a REST endpoint, a chat page, or a set of MCP tools. Each is a surface, a channel callers reach the same published workflow through.

The deployment model

Snapshot

A snapshot is an immutable copy of your workflow taken at the moment you deploy. It is frozen: editing the canvas afterward changes your draft, not the snapshot. Every call to your deployment runs against the snapshot, so a half-finished edit on the canvas never reaches a live caller. Publishing again takes a fresh snapshot of the current draft.

Version

Each snapshot is recorded as a numbered version (v1, v2, and so on) in the Versions table, tagged with who deployed it and when. Versions are independent: one is live at a time, marked with a green dot, and the rest stay available to rename, describe, load back to the canvas, or promote. You publish v1 with Deploy and every later Update adds the next version.

Live version

The live version is the one snapshot currently exposed through every surface. The General tab shows it as Live Workflow, a read-only minimap of exactly what callers run. Only one version is live at a time. Promoting a different version, or updating to a new one, swaps which snapshot is live without affecting the others.

Update

After you change the canvas on a deployed workflow, an Update deployment badge appears in the toolbar to flag that your live version is behind your draft. Clicking Update takes a new snapshot, records it as the next version, and makes it live, all without reopening the deploy modal.

Promote to live

Promote to live makes an earlier version the live one again. It is the fast path for rollback: if a new deployment misbehaves, promote the last known-good version to restore it instantly. Promoting reuses an existing snapshot, so it does not create a new version.

The surfaces

Every surface runs the same live snapshot. You manage them from the tabs of the deploy modal.

Open Logs to confirm which deployment version a run used.