Skip to main content
Version: 5.1

Workflow Executions

The Workflow Executions page lists the runs created by workflows in the selected integration and environment. Select a run to view its status, input, and execution flow, and to reset, suspend, resume, cancel, or terminate it.

Prerequisites
  • The workflow_mgt:view_workflows permission to browse and view executions.
  • The workflow_mgt:manage_workflows permission to reset, suspend, resume, cancel, or terminate an execution.

Open the workflow executions page​

Select Workflows in the console navigation. The console opens the Workflow Executions page for the current integration.

The page header shows the integration name and an environment selector. Use the selector to switch between environments such as dev and prod.

Workflow Executions page showing the environment selector, filters, auto-refresh control, and execution listWorkflow Executions page showing the environment selector, filters, auto-refresh control, and execution list

Browse executions​

Filter executions​

Use the following filters to find an execution:

FilterDescription
Search by workflow IDFinds an execution by its workflow ID.
StatusFilters executions by status: All, Running, Completed, Failed, Terminated, Canceled, or Timed out.
Workflow NameFilters the list by workflow definition, such as orderWorkflow or paymentWorkflow.
Any timeFilters the list by start time: Past 30 minutes, Past 1 hour, Past 24 hours, Past 3 days, Past 7 days, Past 30 days, or Custom, which adds Start From and End On fields.
ClearAppears once a filter is set, and resets them all.

Page actions​

ActionDescription
RefreshReloads the execution list.
Start New WorkflowOpens the form for starting a new workflow execution.
tip

The auto-refresh toggle next to the Updated time keeps the list checking for fresher data every 30 seconds. Turn it off and the list updates only when you refresh it.

Execution list columns​

Each row in the list is one workflow execution, listed newest first. The columns show:

ColumnDescription
Workflow IDThe identifier of the workflow execution. A copy icon next to the value copies the ID.
Run IDThe identifier assigned to the individual workflow run. A copy icon next to the value copies the ID.
Workflow NameThe workflow definition used to create the execution.
StatusThe current state of the execution, such as Running, Completed, Suspended, Terminated, or Canceled.
StartedThe date and time when the execution started.

View an execution​

Select an execution in the list to open the Execution Details panel.

Execution details showing the controls for resetting and managing a workflowExecution details showing the controls for resetting and managing a workflow

The panel header holds the action buttons, which are covered in Manage an execution. Below the header, the panel shows the execution's status and details, its input, and its flow.

Execution status and details​

The Execution card shows the current status of the run and the details that identify it.

FieldDescription
StatusThe current state of the execution, shown as a badge next to the Execution title. For example, Running, Suspended, or Completed.
Instance IDA unique identifier for this execution. A copy icon next to the value copies the ID.
Workflow NameThe workflow definition this execution is an instance of, such as orderWorkflow.
StartedThe date and time the execution began.
ClosedThe date and time the execution finished. This field appears only after the execution is no longer running.

The badge also shows how long a finished execution ran, and a failed execution shows its error message below the fields.

Execution details card showing the instance ID, workflow name, and started timeExecution details card showing the instance ID, workflow name, and started time

Workflow input​

The Workflow Input card shows the data that was provided when the execution started. For example, if you started a workflow with a customer's order details, those details appear here.

Use the {} icon to switch between the structured view and the raw JSON view. Select the copy icon to copy the workflow input. Once the execution completes, a Workflow Result card beside it shows the value it returned.

Workflow Input card showing the data provided when the execution startedWorkflow Input card showing the data provided when the execution started

Execution flow​

Below the cards, the execution flow shows the steps in a workflow execution and how they are connected. For example, it can show:

  • reserveInventory — an activity, marked COMPLETED.
  • payment — a data event the run is WAITING on.
  • if payment — the condition that picks a branch.
  • sendEmail and cancelOrder — the two branches, marked not executed until the data arrives and one of them runs.

The timeline next to the flow shows when each step ran, how long it took, and the total execution time.

Execution flow diagram and timeline showing each step's status, duration, and the total running timeExecution flow diagram and timeline showing each step's status, duration, and the total running time

Select a step to view its details, including the input and execution status.

Execution flow diagram, timeline, and step details panel for a selected stepExecution flow diagram, timeline, and step details panel for a selected step
warning

The execution flow is generated from workflow checkpoints and is an approximation of the execution. It may not show every action performed during the workflow run.

Manage an execution​

Use the action buttons in the panel header to change what happens to an execution:

  • Reset replays the workflow from an earlier point in its history.
  • Suspend pauses a running execution at its current position, and Resume continues it from where it paused.
  • Cancel stops the execution gracefully, so the workflow can run its own cleanup logic.
  • Terminate stops the execution immediately, without running any cleanup logic.
  • Wake, shown only for a running durable agent, ends an in-progress sleep early.
note

The panel shows only the buttons that apply to the execution's current status and your permissions. For example, a completed execution has no Suspend button, and Resume appears only while the execution is suspended. Reset… remains available after the execution closes. All of them need workflow_mgt:manage_workflows.

Reset a workflow​

Select Reset… to open the Reset Workflow dialog, and then choose where to replay from:

  • Before the last step redoes only the most recent workflow task.
  • From the beginning reruns the whole workflow with its original input.
  • A specific point in this run's history starts the replay from a history point you select.
Reset Workflow dialog showing the available history points for replayReset Workflow dialog showing the available history points for replay

Optionally, enter a Reason. Then select Reset Workflow to confirm, or Back to cancel.

Suspend and resume an execution​

The status doesn't change the moment you select Suspend. It can still read Running for a short time, because the console sends the suspension to the workflow as a signal instead of applying it immediately. Once the workflow engine confirms that the run has paused, the status changes to Suspended and Resume replaces Suspend.

Execution details of a suspended execution with the Suspended status and the Resume button highlightedExecution details of a suspended execution with the Suspended status and the Resume button highlighted

Cancel or terminate an execution​

Terminate asks you to confirm in the Terminate Workflow dialog, with an optional reason, and you can't undo it. Prefer Cancel when the workflow has cleanup logic that needs to run.

What's next​