Update a Workflow

Update a workflow. Updates create a new version.

The previous version remains addressable and immutable. Pending and running calls captured at the old version continue against it; new calls run against the new version.

Topology updates

To change the graph you must provide mainNodeName, nodes, AND edges together — partial topology updates are rejected. The full graph is replaced atomically.

Metadata-only updates

Omit all three fields to update only displayName, tags, or name while keeping the topology of the current version.

Reverting

To roll back, fetch the desired prior version and resubmit its mainNodeName/nodes/edges as a new update. Versions themselves are immutable — there is no "pin to version N" operation at the workflow level (use nodes[].function.versionNum to pin individual functions).