Re-execute a flow execution
Re-execute a flow execution, optionally skipping cached results.
This endpoint triggers re-execution of an existing flow execution. It can selectively re-run failed tasks or re-run the entire flow from scratch. Useful for retrying failed executions or refreshing stale data.
Context: - Re-executes workflows that have completed or failed - Can reuse successful task results (cached execution) - Useful for handling transient failures - Updates flow to latest version if changed since original execution - Creates new workflow instance with same execution ID
Execution Modes: 1. Full Re-execution (only_stale=false, default): - Starts workflow from beginning - All tasks execute regardless of previous state - Previous results are discarded - Use for: Complete retry after fixing flow definition
2. Stale-Only Re-execution (only_stale=true):
- Only re-runs tasks marked as 'stale'
- Reuses results from successful tasks
- Faster for partial failures
- Use for: Refreshing outdated data without full re-run
Behavior: - Terminates existing workflow if still running - Updates flow_version to latest version - Maintains same execution ID for traceability - Status transitions: any → running - Does not create new execution record
Performance Notes: - Response time: < 200ms (workflow starts asynchronously) - Stale-only mode significantly faster for large flows - Full re-execution recalculates all task outputs
Use Cases: - Retry failed execution after fixing flow definition - Refresh data after external system updates - Resume execution after transient service outage - Update execution to use latest flow version
Related Endpoints: - GET /flow-executions/{id} - Check re-execution status - POST /flow-executions - Create new execution instead of re-running
Header Parameters
Query Parameters
If true, only re-executes tasks marked as 'stale'. If false (default), re-executes entire flow from beginning. Stale-only mode is faster for flows with many successful tasks.
Path Parameters
UUID of the flow execution to re-execute. Must be an existing execution owned by your organization.
Response
Response Attributes
Standard error detail structure.
This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.
Show child attributes
Response Attributes
Standard error detail structure.
This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.
Show child attributes
Response Attributes
Standard error detail structure.
This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.
Show child attributes
Response Attributes
Show child attributes
Response Attributes
Standard error detail structure.
This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.