flow-executions

Flow execution operations for running and monitoring workflows.

Flow executions represent runtime instances of flows. When you execute a flow, a new flow execution is created with its own unique ID, status, and execution context. Each execution is independent and maintains its own state, input data, and results.

Key concepts:

• Execution Status: Tracks the lifecycle (running, completed, failed, cancelled)
• Run Number: Sequential identifier for executions of the same flow
• Execution Context: Contains input parameters, user information, and metadata
• Task Results: Stores outputs from each task within the execution

Use these endpoints to:

• Start new flow executions with custom input parameters
• Monitor execution progress and status in real-time
• Retrieve execution history and detailed results
• Filter and search executions by status, date, or flow
• Cancel running executions when needed
• Access task-level execution details and outputs

Flow executions transform flow definitions into actual work and deliverable results.