Skip to main content

Error Edges

Purpose: Handle errors and failures in workflow execution Error edges create alternative paths for when nodes fail, enabling graceful error handling and recovery.
Error Edge - API Call node with ERROR handle connecting to Send Notification handler via red dashed line
Error Edge - API Call node with ERROR handle connecting to Send Notification handler via red dashed line
In this example:
  • API Call node has both PARALLEL and ERROR output handles
  • PARALLEL edge (gray dashed) routes to success path (shown partially)
  • ERROR edge (red dashed line with warning icon) connects to Send Notification
  • If API Call fails, execution follows the red error edge
  • Send Notification handles the failure (alerting, logging, recovery)
Characteristics:
  • Visual Style: Red dashed line with warning icon ⚠️
  • Failure Routing: Activates only when source node fails
  • Separate Path: Distinct from normal execution flow
  • Error Data: Passes error information to handler node
How It Works:
1

Node Execution

Source node attempts to execute
2

Failure Detected

Node execution fails (API error, timeout, etc.)
3

Error Edge Activated

Instead of normal edges, error edge is followed
4

Handler Execution

Error handler node receives error details
5

Recovery

Handler can retry, alert, or gracefully fail
Use Cases:
  • API failure handling
  • Retry logic
  • Alerting and notifications
  • Graceful degradation
  • Error logging
Error edges are only followed when the source node fails. For normal execution flow, use parallel or conditional edges.


What’s Next?