Execution History

Every workflow run is logged with detailed information about what happened, when it happened, and whether it succeeded. Use the execution history to monitor your workflows, verify they're running as expected, and troubleshoot any issues.

Viewing Execution History

Finding History for a Workflow

  • Navigate to the Workflows section from the main menu
  • Select the workflow you want to inspect
  • Click the History tab to view all past runs

    • The history list shows runs in reverse chronological order, with the most recent at the top.

    Information Displayed

    Each entry in the execution history shows:

    FieldDescription
    Scheduled TimeWhen the run was supposed to start (for scheduled workflows)
    Actual TimeWhen the run actually began executing
    StatusCurrent state of the run (see status definitions below)
    DurationHow long the run took to complete
    TriggerWhat initiated the run (schedule, manual, webhook, etc.)

    Understanding Run Status

    Each workflow run has one of the following statuses:

    Completed

    The workflow ran successfully from start to finish. All steps executed without errors, and any expected outputs were produced.

    Failed

    An error occurred during execution. The workflow stopped before completing all steps. See the Troubleshooting Failed Runs section for how to diagnose and fix failures.

    Cancelled

    The run was stopped before completion. This happens when:

  • A user manually cancelled the run
  • An approval request was denied
  • A timeout was reached while waiting for approval

    • Running

    The workflow is currently executing. Refresh the page or wait for the run to complete to see final results.

    Pending Approval

    The workflow has reached a step that requires user approval before continuing. The run is paused until someone approves or denies the pending action. Check your notifications or the approval queue to take action.

    Viewing Run Details

    Click on any run in the history list to see complete details about what happened.

    Run Overview

    The detail view shows:

  • Full timestamps for when the run started and ended
  • The trigger that initiated the run
  • Total execution time
  • Final status and any status messages

    • Conversation Thread

    Each workflow run creates a conversation thread that captures the entire execution flow. To view it:

  • Click View Conversation in the run details
  • The thread opens showing the step-by-step execution

    • The conversation thread includes:

  • Each prompt sent to the AI
  • Responses generated at each step
  • Decisions made during execution
  • Any data passed between steps

    • Tool Calls

    The run details show which tools were invoked during execution:

  • Tool name and connector used
  • Input parameters sent to the tool
  • Output returned from the tool
  • Time taken for each tool call
  • Success or failure status

    • This information helps you understand exactly what actions the workflow performed.

    Troubleshooting Failed Runs

    Finding Error Messages

    When a run fails:

  • Open the run details by clicking on the failed run
  • Look for the Error section at the top of the detail view
  • The error message describes what went wrong

    • The conversation thread also shows where the failure occurred. Scroll through to find the step that failed and see the context around the error.

    Common Failure Reasons

    Authentication Errors

    The connector lost access to the external service. Re-authenticate the connector in your integrations settings.

    Rate Limiting

    The external service rejected requests due to too many calls. The workflow may succeed if you run it again later, or consider reducing the frequency of scheduled runs.

    Invalid Data

    The workflow received unexpected data that it couldn't process. Check the input data and any upstream systems that provide data to the workflow.

    Timeout

    The workflow took too long to complete. This can happen with complex workflows or slow external services. Consider breaking the workflow into smaller pieces.

    Tool Not Found

    A tool referenced in the workflow is no longer available. The connector may have been disconnected or the tool removed.

    Approval Timeout

    A step requiring approval was not acted on within the allowed time window.

    What to Do Next

  • Read the error message - It often indicates exactly what went wrong
  • Check the conversation thread - See the context around the failure
  • Verify connector status - Ensure all integrations are still connected
  • Check external services - The issue may be with a third-party service
  • Review recent changes - If the workflow was working before, consider what changed
  • Re-run the workflow - Transient errors may resolve on retry

    • If the issue persists after investigation, you may need to edit the workflow to handle the error case or adjust your integrations.