Skip to main content

Runs

The Runs page provides a unified view of all flow and guide executions. Monitor active runs, review historical executions, and troubleshoot failures.

Accessing Runs​

Click Runs in the sidebar to open the runs view.

Runs Overview​

The runs list displays:

  • Run name (flow or guide title)
  • Status indicator
  • Start time
  • Duration
  • Trigger (who or what started it)

Default View​

By default, you see active and recent runs. Use filters to view historical data.

Run Statuses​

Startup States​

StatusDescription
PendingRun is queued, waiting to start
Identifying ToolsSystem is identifying required tools
Scheduled for ExecutionRun will start at a scheduled time
Ready for ExecutionRun is about to begin

Active States​

StatusDescription
Executing TriageRunning diagnostic steps
Deciding RemediationAI determining which remediation to run
Ready for RemediationTriage complete, remediation ready
Executing RemediationRunning resolution steps
SummarizingGenerating execution summary

Waiting States​

StatusDescription
Waiting for User Input (Triage)A triage step needs your input
Waiting for User Input (Remediation)A remediation step needs your input

Completion States​

StatusDescription
Completed SuccessRun finished successfully
Completed FailureRun completed with failures
Completed PartialSome steps succeeded, some failed
CancelledRun was stopped by user
No StepsNo steps were found to execute

Viewing Run Details​

Click any run to see detailed information:

Progress View​

For active runs:

  • Current step highlighted
  • Completed steps checked off
  • Real-time tool execution display
  • Variable values

Results View​

For completed runs:

  • Step-by-step execution log
  • Time spent on each step
  • Tool inputs and outputs
  • Final outcome and summary

Timeline​

See the chronological sequence:

  • When each step started and finished
  • Wait times for user input
  • Total duration breakdown

Working with Active Runs​

Joining a Run​

Click an active run to join it. You can:

  • Watch execution progress in real-time
  • Respond to steps requiring input
  • Monitor variable values

Responding to User Input​

When a run waits for user input:

  1. The run status shows "Waiting for User Input"
  2. Open the run
  3. Read the prompt or question
  4. Provide your response
  5. The run continues

Cancelling a Run​

To stop a run in progress:

  1. Open the run
  2. Click Cancel
  3. Confirm cancellation

The run stops immediately and is marked as Cancelled.

Filtering Runs​

By Status​

Filter to see:

  • Active runs only
  • Completed runs
  • Failed runs
  • Cancelled runs

By Type​

  • All — Flows and guides
  • Flows — Flow runs only
  • Guides — Guide runs only

By Time Range​

  • Last 24 hours
  • Last 7 days
  • Last 30 days
  • Custom range

By Flow/Guide​

Search for runs of a specific flow or guide by name.

Troubleshooting Failed Runs​

Understanding Failures​

When a run fails, review:

  1. Which step failed — Identify the point of failure
  2. Error message — Read the specific error
  3. Tool output — Check raw tool results
  4. Variable values — Verify inputs were correct

Common Failure Causes​

CauseResolution
Tool timeoutCheck tool availability, increase timeout
Invalid inputVerify input variable values
Tool errorCheck tool logs, verify permissions
Network issueCheck outpost connectivity
Missing permissionsVerify user has required access

Retrying Runs​

For failed runs that can be retried:

  1. Open the run details
  2. Review what failed
  3. Fix the underlying issue
  4. Start a new run of the same flow/guide

Run Management​

Deleting Runs​

Remove runs from history:

  1. Select runs to delete
  2. Click Delete
  3. Confirm deletion

Deleted runs cannot be recovered.

Exporting Run Data​

Export run details for analysis or compliance:

  1. Open a run
  2. Click Export
  3. Choose format (JSON, CSV)

How Runs Are Created​

Runs are started by:

  • Running from Chat — "Run the database health check flow"
  • Running from Flows/Guides page — Click Run on a flow or guide
  • External triggers — Integrations starting runs automatically
  • Scheduled execution — Flows configured to run on schedule

The Runs page is for viewing and managing runs, not creating them.

Best Practices​

Monitor Active Runs

Check regularly for runs waiting on user input—they can't proceed without you.

Review Failed Runs Promptly

Understand why runs fail to improve your flows and prevent recurring issues.

Use Filters

With many runs, filters help you find what you need quickly.

Clean Up Old Runs

Delete old runs periodically to keep history manageable and relevant.

  • Flows — Create and manage flows
  • Guides — Create and manage guides
  • Chat — Start runs from conversation