> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frayme.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Execution history

> Every run of a flow: filters, the run ledger per step, failed runs and replay.

export const Shot = ({id, alt, caption}) => <Frame caption={caption}>
    <img className="block dark:hidden rounded-lg" src={`/images/guides/${id}.light.png`} alt={alt} loading="lazy" decoding="async" />
    <img className="hidden dark:block rounded-lg" src={`/images/guides/${id}.dark.png`} alt={alt} loading="lazy" decoding="async" />
  </Frame>;

**Executions** in the toolbar opens **Execution history**: recent runs of this flow, refreshed every ten seconds.

<Shot id="engineer/exec-01-list" alt="Execution history sheet" caption="Runs with status, decision and run type." />

## Filter

**Filter by case ID…** narrows to one case. Tabs filter by **Status** (**All**, **Success**, **Failed**, **Running**), **Decision** (**Any decision**, **Approved**, **Declined**, **In review**) and **Run type** (**All runs**, **Dry runs**, **Real**), each with counts.

<Shot id="engineer/exec-02-filter-dryrun" alt="Dry runs only" caption="Only dry runs." />

## Read a run

Each row shows the status icon, the subject or case id, the version that ran, an error summary for failed runs, start time, duration, trigger and the decision. Click a row to open the ledger.

## Inspect a step

The ledger lists every step with **Result** (what it produced), **Changed** (what it wrote to the case state), **Evidence** (the full output and the state the step saw), **Definition**, **Run payload**, **Dispatch** (for paused steps) and **Raw record**. Copy buttons put any block on the clipboard. An **Issues** summary collects warnings and errors.

<Shot id="engineer/exec-03-detail-v2" alt="Run ledger" caption="Result, Changed and Evidence for a step." />

## Failed runs

A failed run shows the error in the list and the failing step in the ledger. The example below is a Script step raising an error.

<Shot id="engineer/exec-06-failed-run" alt="Failed run" caption="The error summary points at the failing step." />

## Replay

**Replay** re-opens [Submit case](/guides/engineer/workflow-submit-case) with the run's original payload so you can run it again, typically against the draft you are fixing.
