Skip to content

Workflow Runs

Purpose

Monitor active and completed workflow executions on the Runs tab of the Workflows page. Review running, completed, stopped, and failed workflows, then open any run for full approval history and timeline details.

Prerequisites

  • You are signed in to EisenVault One.
  • Workflow features are enabled in your environment (see Environment availability below).
  • Your account has the view_approval_flow permission, or you started the workflow and can view your own runs.

Environment availability

In non-production environments (staging and development), Workflow appears in the left navigation. The Workflow navigation item is hidden in production builds.

Before You Begin

The Runs tab complements the Templates tab on the Workflows page:

  • Templates — workflow definitions and versions.
  • Runs — live and historical executions of those workflows on specific files.

Summary cards at the top show:

Card Meaning
Running Workflows currently executing
Completed Workflows that finished successfully
Stopped / Failed Workflows that were terminated or errored
Total runs All executions in the list

Open the Runs Tab

  1. Sign in to EisenVault One.
  2. Click Workflow in the left navigation.
  3. Select the Runs tab.

You can also reach the Runs tab from the Templates tab by clicking the Active runs summary card. The card hint reads Currently executing — view runs — click anywhere on the card to switch tabs.

Search and Filter Runs

Control Purpose
Search Search by instance ID, workflow name, or file name
Status Filter by All status, Running, Completed, Stopped, Failed, or Timed out

The summary cards above the list combine Stopped and Failed into one Stopped / Failed count. The status filter treats Stopped, Failed, and Timed out as separate values.

Click the refresh icon to reload the list.

Runs List Columns

Column Description
Instance ID Unique identifier for the workflow run (click to open details)
Workflow Workflow name and the file under review
Status Running, Completed, Stopped, Failed, or Timed out
Started When the workflow began
Current step Active approval step, pending approver, or final state such as Completed

Open a Workflow Run

  1. On the Runs tab, locate the workflow instance.
  2. Click the Instance ID or workflow row.
  3. EisenVault One opens the run detail view for that workflow instance.

The run detail view shows workflow name, document name, priority, due date, request note, workflow progress, approval history, and task timeline. Use Back to workflow runs at the top of the page to return to the list.

To complete an assigned approval step, use Pending Approvals instead.

Example Walkthrough

  1. Open Workflow and select the Runs tab.

    Workflows Runs tab with status summary cards and run list

    The screenshot shows the Runs tab layout. When workflow runs exist in your tenant, the table lists Instance ID, Workflow, Status, Started, and Current step rows instead of the empty state.

  2. Filter by Running to see in-progress workflows.

  3. Click an Instance ID to open the full run detail view.

Expected Result

  • Status summary cards reflect current workflow activity.
  • Search and status filters narrow the runs list.
  • Clicking a run opens the full run detail and timeline view.

Troubleshooting

If the Runs tab shows Request failed with status code 421 or Failed to load workflows, the workflow list API did not return data. Summary cards may show zero and the table may read No workflow runs found even when runs exist in your tenant.

Try these steps:

  1. Click Refresh on the Runs tab.
  2. Confirm your account has the view_approval_flow permission.
  3. Ask your administrator to verify the workflow service is healthy on the deployment.
  4. Sign out and sign back in, then open WorkflowRuns again.

If the error persists after deployment verification, contact EisenVault One support with the HTTP status code and the time the error occurred.