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

# Workflow history

> Monitor and inspect jobs, the execution steps of workflow runs.

The **Workflow History** provides a complete log of all workflow executions in your workspace. Use it to audit activity, trace issues, and verify that automated processes ran as expected. By consolidating all workflow executions in one place, the Workflow History provides a clear operational trace of your document-processing activity.

## Job history list

<Frame>
  <img src="https://mintcdn.com/invopop/fWniCD0icTwRKXxR/assets/console/job-history.png?fit=max&auto=format&n=fWniCD0icTwRKXxR&q=85&s=57bbf6d6d352e197609631eda75e441d" width="100%" alt="Job history view showing workflow executions" data-path="assets/console/job-history.png" />
</Frame>

At the top of the page, use **filters** to narrow the list of executions:

* **Job ID** — Search for a specific job ID
* **Workflow** — Filter by workflow name
* **Status** — Display jobs that are running, completed or completed with errors

These controls help you locate specific jobs or focus on executions relevant to your debugging session.

The **main table** displays each workflow execution with the following information:

* **Started at** — UTC timestamp when the job began.
* **Job ID** — Unique identifier for the run. Use the copy button to share when reporting issues or cross-referencing logs.
* **Workflow** — Name and version of the workflow that was executed. This helps distinguish between different automation paths or schema versions.
* **Duration** — Total time the job took to complete. Short values indicate normal behavior, while longer durations usually indicate long running processes such as waiting for a supplier to register. Our workflow steps have expected durations, and if a step takes longer than expected it will `KO` and the job will fail.
* **Status** — Visual indicator showing whether a job is running (yellow), completed successfully (green) or ended with an error (red).

<Info>
  Each job shows the specific workflow version that processed it. This helps you correlate workflow changes with job outcomes. For more information, see [Workflow versions](/console/workflow-versions).
</Info>

## Job detail

Click any job in the history table to view its execution details. This view provides a step-by-step trace of the workflow run, showing how the workflow progressed, which actions were taken, and where any failures occurred.

<Frame>
  <img src="https://mintcdn.com/invopop/fWniCD0icTwRKXxR/assets/console/job-detail.png?fit=max&auto=format&n=fWniCD0icTwRKXxR&q=85&s=41b94ba3030300113e6dd0435e8856a4" width="508" alt="Job execution details view" data-path="assets/console/job-detail.png" />
</Frame>

### Summary information

At the top of the details view, a summary panel displays key metadata:

| Field             | Description                                                                                                                                                             |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Status**        | Final outcome of the job run (completed, completed with errors, or failed)                                                                                              |
| **Started at**    | UTC timestamp when execution began                                                                                                                                      |
| **Duration**      | Total processing time                                                                                                                                                   |
| **Job ID**        | Unique identifier with a copy button for sharing                                                                                                                        |
| **Workflow ID**   | Identifier of the workflow definition used. Clicking <kbd>↗</kbd> will take you to the specific [workflow version](/console/workflow-history) used to execute this job. |
| **Silo Entry ID** | Reference to the underlying data record processed by the workflow. Clicking <kbd>↗</kbd> will take you entry processed with this job.                                   |

Use the <kbd>Run again</kbd> button to re-execute the same job, useful for iterative reprocessing after fixing issues.

### Reading the execution trace

Below the summary, each workflow step is listed in execution order. Every step shows:

* **Status** — Last known status text for this job. Can be one of the following:

  |          |                                               |
  | -------- | --------------------------------------------- |
  | `RUN`    | attempting to execute the task.               |
  | `QUEUED` | processor requested more time, job is queued. |
  | `ERR`    | recoverable error, can try again.             |
  | `OK`     | job completed successfully.                   |
  | `SKIP`   | not executed, reason will be stated.          |
  | `KO`     | unrecoverable failure ("knocked out").        |
* **Intent ID** — Unique identifier for the step execution
* **Log output** — Detailed execution logs (expandable for failed steps)

### Identifying failures

When a step fails, expand its log output to see:

* **RUN** — When the step started executing
* **KO** — When the step failed
* **Error message** — Specific validation errors, API responses, or other failure details

Use this information to understand what went wrong. Common issues include:

* Missing required fields in the document data
* Validation errors from tax authorities or service providers
* Network or API connectivity problems
* Configuration errors in workflow steps

### Fixing issues

After identifying the failure:

1. Review the error message to understand what's missing or incorrect
2. Check the document data or workflow configuration
3. Make the necessary corrections
4. Use <kbd>Run again</kbd> to test the fix
5. Verify the job completes successfully

This view is essential for diagnosing validation errors, signature issues, or logic faults in your workflows. The step-by-step trace and detailed logs make it straightforward to identify exactly where and why a workflow failed.

## Related resources

|                |                                                                                                                                                                    |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| API Reference  | <Icon icon="code" /> [Fetch a job](/api-ref/transform/jobs/fetch-a-job)<br /><Icon icon="code" /> [Fetch a job by key](/api-ref/transform/jobs/fetch-a-job-by-key) |
| Related Guides | <Icon icon="book" /> [Workflows Guide](/guides/workflows)                                                                                                          |
