Skip to content

Commit 2ce4561

Browse files
[docs] Self-healing documentation fix: workflow_run.conclusion filter - 2026-04-30 (#29324)
1 parent bc210fb commit 2ce4561

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

docs/src/content/docs/reference/triggers.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -279,6 +279,20 @@ Workflows with `workflow_run` triggers include automatic security protections:
279279

280280
See the [Security Architecture](/gh-aw/introduction/architecture/) for details.
281281

282+
#### Conclusion Filtering (`conclusion:`)
283+
284+
Use `conclusion:` to restrict the trigger to specific workflow run outcomes. Accepts a single value or a list. Compiles into a guarded `if:` condition — other events in the same `on:` block are unaffected.
285+
286+
```yaml wrap
287+
on:
288+
workflow_run:
289+
workflows: ["CI"]
290+
types: [completed]
291+
conclusion: [failure, cancelled]
292+
```
293+
294+
Valid values: `success`, `failure`, `cancelled`, `skipped`, `timed_out`, `action_required`, `neutral`, `stale`.
295+
282296
### Deployment Status Triggers (`deployment_status:`)
283297

284298
Trigger workflows when a GitHub deployment status changes. [Full event reference](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#deployment_status).

0 commit comments

Comments
 (0)