The convert command has three modes. Default: convert a live Flow Designer flow by sys_id. --from-xml: convert a flow from an update-set XML export (offline). --workflow: convert a legacy Workflow Editor workflow by sys_id into a Flow Designer manifest.
convert
Convert a flow or legacy workflow into a manifest — live flow by default; --from-xml for offline flow XML; --workflow for Workflow Editor migration.
sn convert <flow_sys_id> [--output <path>] [--prefix <p>] Convert a live Flow Designer flow by sys_id.
Arguments
| Name | Required | Description |
|---|---|---|
| flow_sys_id | Yes | sys_id of the sys_hub_flow to convert. |
Flags
| Flag | Default | Description |
|---|---|---|
| --output <path> | — | Write the manifest to a file (default: stdout). |
| --prefix <p> | converted_ | `internal_name` prefix. |
Examples
sn convert c4a90a4183184310d3cfe5d0deaad3c3 --output ./converted/manifest.tssn convert <export.xml> --from-xml [--flow <sys_id>] [--output <path>] [--prefix <p>] [--list] [--resolve-instance] Convert a flow from an update-set XML export (offline).
Arguments
| Name | Required | Description |
|---|---|---|
| export.xml | Yes | Canonical ServiceNow XML export containing one or more flows. |
Flags
| Flag | Default | Description |
|---|---|---|
| --from-xml | — | Selects XML-flow mode. |
| --flow <sys_id> | — | Target flow sys_id (required if the export has multiple). |
| --output <path> | — | Write the manifest to a file (default: stdout). |
| --prefix <p> | converted_ | `internal_name` prefix. |
| --list | — | List every flow in the export and exit. |
| --resolve-instance | — | Fall back to live API for action-type refs not carried in the XML (hits the instance). |
Examples
sn convert export.xml --from-xml --listsn convert export.xml --from-xml --flow abc123 --output ./onboarding/manifest.tssn convert <workflow_sys_id> --workflow [--output <path>] Convert a legacy Workflow Editor workflow to a Flow Designer manifest.
Arguments
| Name | Required | Description |
|---|---|---|
| workflow_sys_id | Yes | sys_id of the wf_workflow to convert. |
Flags
| Flag | Default | Description |
|---|---|---|
| --workflow | — | Selects Workflow Editor mode. |
| --output <path> | — | Write the manifest to a file (default: stdout). |
Examples
sn convert 7c13deef87aa2a100f22cd56cebb35dd --workflow --output ./legacy/manifest.tsUnknown action/logic types and catalog-trigger config beyond table binding surface as FIXME inline comments in the output. Inspect before executing.
After converting a flow, run sn test with flowFidelity enabled — it diffs the rebuilt label_cache against the source flow, catching pills that did not round-trip.