diff --git a/agent/workflows.mdx b/agent/workflows.mdx index 9e0bc6db4..f472ca0e1 100644 --- a/agent/workflows.mdx +++ b/agent/workflows.mdx @@ -21,6 +21,27 @@ Use workflows that run on a schedule to automate recurring tasks like publishing Use workflows that run on push events to automate reactive maintenance tasks like updating API references or identifying documentation updates needed for new features. +## Run history + +The [Workflows](https://dashboard.mintlify.com/products/workflows) page in the dashboard has a **Run history** tab that shows a unified view of all workflow runs across your project. + +Each run displays: + +- **Time** — when the workflow ran. +- **Workflow** — which workflow triggered the run. +- **Status** — the current state of the run: queued, running, failed, PR merged, PR closed, review needed, or no action needed. +- **Summary** — a brief description of what the agent did. + +Use the workflow filter dropdown to view runs for a specific workflow. By default, the run history shows only runs with open pull requests. Toggle **Show all runs** to include runs where the pull request was already merged or closed. + +### Close a pull request + +If a workflow run opened a pull request that you don't want to merge, you can close it directly from the run history table without navigating to GitHub. Click the **Close PR** button on the run entry. + +### View changes in the editor + +Each run links to its branch in the dashboard editor so you can review the agent's changes before merging. + ## Create a workflow ### Create a workflow in the dashboard