Workflow execution events

Workflow execution events are internal logs for a workflow run. To record durable custom facts or trigger workflows, use project events.

​

Event categories

• execution_started - Workflow begins
• execution_ended - Workflow completes
• execution_failed - Workflow crashes

• step_entered - Entering a step
• step_completed - Step finishes successfully
• step_failed - Step encounters error

• action_preparing - Setting up action
• action_executing - Running action
• action_performed - Action completes
• decision_evaluated - Decide node chooses path

​

Accessing events

​

Test workflows

​

Production workflows

• Project → Execution logs → Click execution → Events tab
• Real-time updates for active workflows
• Full execution history

​

Key event types

• decision_evaluating - AI evaluating conditions
• decision_evaluated - Path chosen with reasoning

• variables_set - Variables updated
• Shows old/new values and source

• ai_field_resolving - Processing AI prompt
• ai_field_resolved - AI response received

• user_input_received - User responded
• timeout_scheduled - Timeout scheduled for wait step
• timeout_cancelled - Timeout cancelled (user responded before timeout)
• timeout_triggered - Timeout fired (no user response received)

• step_failed - Step error with details
• action_failed - Action error

​

Event structure

{
  "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
  }
}

• eventType - What happened
• createdAt - Exact timestamp
• step - Associated step (if any)
• edgeLabel - Transition taken
• payload - Event-specific data

• 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