# workflows-history

Shows the run history of one deployed Zapier workflow, including status, timing and errors.

Skill by Zapier. Category: Shipping and ops.

## Install

Project (for this project only):

```sh
npx skills add zapier/agent-skills --skill workflows-history
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add zapier/agent-skills --skill workflows-history -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Warn

Installs: 398. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/zapier/agent-skills/workflows-history)

## Source

[Open the source](https://github.com/zapier/agent-skills/tree/HEAD/skills/workflows/history). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: workflows-history
description: Show run history for a specific durable workflow using the Zapier SDK experimental Code Workflows commands. Use when the user asks for run history, execution history, what happened with this Zap, or how a workflow fired.
license: MIT
metadata:
  author: zapier
  version: "1.2.1"
  sdk_cli_min: "0.74.0"
  sdk_cli_validated: "0.74.0"
  refresh_source: "zapier/agent-skills"
---

# Zapier Workflows History

Use the public SDK CLI experimental command surface. Do not use `zapier-sdk-code-substrate`.

## Compatibility Gate

Before using this skill, run the `workflows-doctor` bundle compatibility check. If `workflows-doctor` is not installed or cannot be loaded, run `workflows-install` or install `workflows-doctor` from `zapier/agent-skills` before continuing. If `workflows-doctor` reports SDK/skill drift, follow its refresh instructions, stop this skill invocation, reload the agent workspace if needed, and ask the user to rerun the original request.

## Identify The Workflow

If the user provides a workflow ID, use it directly.

If the user refers to the workflow by name or description, list workflows first and find the matching ID:

```bash
zapier-sdk --experimental list-workflows --json
```

If multiple workflows match, show the candidates and ask the user which one they mean.

## Fetch Run History

```bash
zapier-sdk --experimental list-workflow-runs <workflow-id> --json
```

Parse the JSON output. Useful fields may include `id`, `status`, `started_at`, `finished_at`, `input`, and `output`.

When the workflow ID is known, include the Zapier editor link:

```text
https://zapier.com/durables-editor/<workflow-id>
```

## Drill Into A Run

If a single deployed workflow run failed or the user wants step-level detail:

```bash
zapier-sdk --experimental get-workflow-run <run-id> --json
```

Use `get-durable-run <run-id>` only for one-off synthetic runs created by `zapier-sdk --experimental run-durable`, not for deployed workflow runs returned by `list-workflow-runs`.

If a manual trigger response returns a trigger ID before a workflow run ID is available, bridge from trigger to run:

```bash
zapier-sdk --experimental get-trigger-run <trigger-id> --json
```

Summarize the failure, status, timing, input, output, and any step error details that appear in the response. Avoid dumping raw JSON unless the user asks for it.

## Draft State

Runs execute published versions — unpublished draft edits never show up in run history. If the user expects a recent change to be reflected in runs and it isn't, check for an open draft holding that change:

```bash
zapier-sdk --experimental list-workflow-drafts <workflow-id> --json
```

If an open draft exists, tell the user their change is unpublished (note `last_edited_at` and the editor link) rather than concluding the workflow is broken.
````

- Previous: [workflows-modify](https://syn4pse.dev/terminal/zapier-workflows-modify.md)
- Next: [workflows-install](https://syn4pse.dev/terminal/zapier-workflows-install.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
