​

Publish a Workflow

Publishing creates an immutable snapshot of your workflow. The draft remains editable — you can keep iterating without affecting live calls.

​

How to Publish

1. Open your workflow in the editor
2. Click the Publish button
3. Enter a change description (e.g., “Added billing subagent node”, “Fixed transfer condition”)
4. Confirm

The version number auto-increments (v1, v2, v3…).

​

What Happens on Publish

1. The current state of all nodes and edges is snapshotted
2. A SHA-256 checksum is computed for integrity verification
3. A new WorkflowVersion record is created
4. The workflow status changes to Published
5. If linked to a phone number, the latest version is used for routing

​

Publishing Best Practices

• Write meaningful descriptions — they show up in the version history
• Test before publishing — use the conversation simulator
• Rolling back — link the phone number to a previous version
• Keep drafts lean — delete unused nodes before publishing

​

Version History

View all versions from the workflow editor:

1. Click the Version History button
2. See each version’s number, description, and timestamp
3. Click a version to inspect its configuration
4. Phone numbers can be linked to any specific version

​

Linking to a Phone Number

After publishing, link the workflow to a phone number:

1. Go to Phone Numbers in the sidebar
2. Find the number and click Link
3. Select Workflow as the resource type
4. Choose the workflow and optionally a specific version
5. Confirm

​

Status Reference