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

# Jobs

> Monitor and manage runbook execution jobs in the Web Console.

## Overview

The Jobs page shows all runbook executions with real-time status updates. Filter, monitor, and manage jobs from a single view.

## Job statuses

| Status               | Description                                 |
| -------------------- | ------------------------------------------- |
| Scheduled            | Waiting for the scheduled execution time    |
| Queued               | In the job queue, waiting for a worker      |
| Running              | Currently executing steps                   |
| Waiting for approval | Paused, waiting for user approval on a step |
| Paused               | Manually paused by a user                   |
| Completed            | Finished successfully                       |
| Failed               | Finished with one or more errors            |
| Cancelled            | Cancelled by a user                         |

## Filtering jobs

Use the status filter tabs to view:

* **All** — All jobs
* **Running** — Currently executing
* **Completed** — Successfully finished
* **Failed** — Finished with errors

The job list auto-refreshes every 10 seconds.

## Job detail view

Click on a job to see its detail page with:

### Step timeline

Each step shows:

* Status badge (success, failed, skipped, running)
* Duration
* Retry count (if any)
* Captured values
* Error details and diagnostics (for failed steps)

### Live screenshots

During execution, screenshots are streamed in real-time via SSE. View the current browser state as steps execute.

### Execution metrics

| Metric          | Description                       |
| --------------- | --------------------------------- |
| Total duration  | End-to-end execution time         |
| Steps succeeded | Number of successful steps        |
| Steps failed    | Number of failed steps            |
| Retry count     | Total selector resolution retries |

### Artifacts

After execution, view and download:

* **Screenshots** — Captured during execution
* **Videos** — Screen recordings (Business+)
* **Exports** — CSV/JSON files from export actions
* **Downloads** — Files downloaded during execution

## Job actions

| Action      |             When available            | Description              |
| ----------- | :-----------------------------------: | ------------------------ |
| **Approve** |          Waiting for approval         | Approve the pending step |
| **Reject**  |          Waiting for approval         | Reject and fail the step |
| **Pause**   |                Running                | Pause execution          |
| **Resume**  |                 Paused                | Resume paused execution  |
| **Cancel**  | Running, Paused, Waiting for approval | Cancel the job           |

## Real-time updates

Job details use Server-Sent Events (SSE) for real-time updates. The page automatically shows:

* Step completion as it happens
* Live screenshot streaming
* Approval request dialogs
* Final execution report
