From 3872b71278b489cb041f4cc749eabfbc8160b11b Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 30 Apr 2026 13:38:15 +0000 Subject: [PATCH 1/2] docs(triggers): document workflow_run.conclusion filtering Add Conclusion Filtering subsection to the Workflow Run Triggers section, mirroring the existing deployment_status.state documentation. The on.workflow_run.conclusion field (added in #29089) compiles into a guarded if: condition at build time, allowing users to filter workflow runs by their conclusion without writing the two-part GitHub Actions expression guard manually. Co-Authored-By: Claude Sonnet 4.6 --- docs/src/content/docs/reference/triggers.md | 26 +++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/src/content/docs/reference/triggers.md b/docs/src/content/docs/reference/triggers.md index 9fbb59f02b2..b402e5f1606 100644 --- a/docs/src/content/docs/reference/triggers.md +++ b/docs/src/content/docs/reference/triggers.md @@ -279,6 +279,32 @@ Workflows with `workflow_run` triggers include automatic security protections: See the [Security Architecture](/gh-aw/introduction/architecture/) for details. +#### Conclusion Filtering (`conclusion:`) + +Use `conclusion:` to restrict the trigger to specific workflow run outcomes. The compiler compiles this into a guarded `if:` condition so the workflow only runs for the matching conclusions. Other combined triggers (such as `workflow_dispatch`) are not blocked by the guard. + +```yaml wrap +on: + workflow_run: + workflows: ["CI"] + types: [completed] + conclusion: failure # Single conclusion +``` + +```yaml wrap +on: + workflow_run: + workflows: ["CI"] + types: [completed] + conclusion: [failure, cancelled] # Multiple conclusions + workflow_dispatch: # Safely combined — guard ensures dispatch passes through +``` + +Valid `conclusion` values: `success`, `failure`, `cancelled`, `skipped`, `timed_out`, `action_required`, `neutral`, `stale`. + +> [!NOTE] +> The `conclusion` field compiles into a GitHub Actions `if:` condition: `github.event_name != 'workflow_run' || (github.event.workflow_run.conclusion == 'failure')`. This means the workflow still runs when triggered by other events in the same `on:` block. + ### Deployment Status Triggers (`deployment_status:`) 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). From 793e2b7cd674cf45523a19734a4774314755e665 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 30 Apr 2026 13:50:51 +0000 Subject: [PATCH 2/2] docs(triggers): trim workflow_run.conclusion section Agent-Logs-Url: https://github.com/github/gh-aw/sessions/3c1adbce-ef78-46bf-88b4-f16303d22c31 Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- docs/src/content/docs/reference/triggers.md | 18 +++--------------- 1 file changed, 3 insertions(+), 15 deletions(-) diff --git a/docs/src/content/docs/reference/triggers.md b/docs/src/content/docs/reference/triggers.md index b402e5f1606..6222f60aac7 100644 --- a/docs/src/content/docs/reference/triggers.md +++ b/docs/src/content/docs/reference/triggers.md @@ -281,29 +281,17 @@ See the [Security Architecture](/gh-aw/introduction/architecture/) for details. #### Conclusion Filtering (`conclusion:`) -Use `conclusion:` to restrict the trigger to specific workflow run outcomes. The compiler compiles this into a guarded `if:` condition so the workflow only runs for the matching conclusions. Other combined triggers (such as `workflow_dispatch`) are not blocked by the guard. +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. ```yaml wrap on: workflow_run: workflows: ["CI"] types: [completed] - conclusion: failure # Single conclusion + conclusion: [failure, cancelled] ``` -```yaml wrap -on: - workflow_run: - workflows: ["CI"] - types: [completed] - conclusion: [failure, cancelled] # Multiple conclusions - workflow_dispatch: # Safely combined — guard ensures dispatch passes through -``` - -Valid `conclusion` values: `success`, `failure`, `cancelled`, `skipped`, `timed_out`, `action_required`, `neutral`, `stale`. - -> [!NOTE] -> The `conclusion` field compiles into a GitHub Actions `if:` condition: `github.event_name != 'workflow_run' || (github.event.workflow_run.conclusion == 'failure')`. This means the workflow still runs when triggered by other events in the same `on:` block. +Valid values: `success`, `failure`, `cancelled`, `skipped`, `timed_out`, `action_required`, `neutral`, `stale`. ### Deployment Status Triggers (`deployment_status:`)