Flow events automatically track every step of execution - from start to finish, including decisions, actions, and errors. Use events to debug flows and understand what happened during execution.

​
Event categories

Execution events - Flow lifecycle
  • execution_started - Flow begins
  • execution_ended - Flow completes
  • execution_failed - Flow crashes
Step events - Step transitions
  • step_entered - Entering a step
  • step_completed - Step finishes successfully
  • step_failed - Step encounters error
Action events - Node actions
  • action_preparing - Setting up action
  • action_executing - Running action
  • action_performed - Action completes
  • decision_evaluated - Decide node chooses path

​
Accessing events

​
Test flows

Events appear in the Flow Events tab when testing flows. Events show step-by-step execution with timestamps and details.

​
Production flows

View events in execution logs dashboard:
  • Project → Execution logs → Click execution → Events tab
  • Real-time updates for active flows
  • Full execution history

​
Key event types

Decision tracking
  • decision_evaluating - AI evaluating conditions
  • decision_evaluated - Path chosen with reasoning
Variable changes
  • variables_set - Variables updated
  • Shows old/new values and source
AI field resolution
  • ai_field_resolving - Processing AI prompt
  • ai_field_resolved - AI response received
User interactions
  • user_input_received - User responded
  • wait_timeout - Timeout triggered
Errors
  • step_failed - Step error with details
  • action_failed - Action error

​
Event structure

Each event includes: 
{
  "id": "uuid",
  "eventType": "step_entered", 
  "createdAt": "2024-01-01T12:00:00Z",
  "step": {
    "identifier": "welcome_step",
    "stepableType": "FlowSendTextStep"
  },
  "edgeLabel": "next",
  "payload": {
    "step_identifier": "welcome_step",
    "duration_ms": 150
  }
}
Core fields
  • eventType - What happened
  • createdAt - Exact timestamp
  • step - Associated step (if any)
  • edgeLabel - Transition taken
  • payload - Event-specific data
Payload examples
  • Decision events include prompt, response, model used
  • Action events show parameters and results
  • Error events contain error message and stack trace
  • Variable events show before/after values
Events provide complete audit trail of flow execution for debugging and monitoring.