Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ctrlnode.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Run statuses

Workflow runs use the same state machine as pipelines:
StatusMeaning
draftDefinition not yet activated
activeRun in progress
doneAll steps finished successfully
blockedWaiting on agent or external failure
failedTerminal failure
cancelled / archivedStopped or hidden from active lists
The app loads allowed actions from /pipelines/status-machine (e.g. Start, Resume, Cancel, Rerun, Archive).

​
Recovery actions

ActionRequires BridgeNotes
ResumeYesContinue from blocked/failed where policy allows
RerunYesNew attempt; hidden when Bridge offline
Clone to draftYesCopy definition for editing a new version
Cancel—Stop in-flight work
Clone and Rerun need a live Bridge connection — the API returns 503 if no agent runtime is connected.

​
Blocked runs

When a step task is blocked, fix agent credentials or instructions on the task detail page, then Retry or move to backlog per task rules. Pipeline-level Resume may be available depending on status.

​
Definitions with zero nodes

You can save an empty workflow definition (zero nodes) as a draft placeholder — useful while designing, but activation requires at least one valid step.