# Workflow runs

URL: https://docs.usestitch.ai/docs/triggers/github/workflow_run



## Schema [#schema]

[Workflow run JSON Schema](/schema/github-workflow_run.json)

`eventType: workflow_run`. Actions: `completed`, `requested`.

```yaml
key: fix-workflow
name: Fix failed workflow
provider: github
eventType: workflow_run
actions: [completed]
harness: coding-agent
sandbox: workspace
agentId: build
initialPrompt: Inspect the failed workflow and fix the cause.
conclusions: [failure]
workflows: [.github/workflows/ci.yml]
enabled: false
```

## Filters [#filters]

Supported: `branches`, `conclusions`, `workflows`, `ignoreBots`, `actorLogins`.
Workflow selectors are paths such as `.github/workflows/ci.yml` or `.yaml`, not display names.
`completed` requires conclusions. A conclusions filter accepts only completed actions;
put `requested` in a separate trigger.
Conclusions: `success`, `failure`, `neutral`, `cancelled`, `timed_out`, `action_required`,
`stale`, `skipped`, `startup_failure`.
See [shared matching rules](/docs/triggers/github#filters).

## Guards [#guards]

Scopes: `repository`, `commit`, `event`; `delivery` for `deduplicate`.
PR `subject` and source/target branch scopes are unsupported.
See [guard types](/docs/triggers#guards).