Goal

Use the nb api workflow command surface to orchestrate workflows end-to-end: design trigger logic, build node chains, manage versions, and inspect execution results.

CLI usage rules:

1. Use nb api workflow as the canonical command namespace for workflow operations.
2. If the CLI is available but not authenticated for the target app, stop and guide the user to authenticate the CLI before continuing.
3. Before using an nb api workflow subcommand you have not used yet in the current task, run its -h once and follow the generated help text for flags and examples.

Scope

• Handle: inspect workflow definitions, nodes, version state, executions, and failed jobs.
• Handle: create new workflows for business targets, then configure triggers and nodes sequentially.
• Handle: update existing workflows by creating a new revision first when the current version is frozen.
• Handle: enable workflows, move/duplicate/delete nodes or branches, and execute workflows only after explicit high-risk confirmation.
• Handle: diagnose failed executions and identify the failed job, node, or configuration mismatch.
• Handle: approval initiator, approver, and task-card UI authoring through flowSurfaces when the UI is bound to workflow or approval-node config.