{"id":15650152,"url":"https://github.com/ahmadnassri/action-workflow-run-wait","last_synced_at":"2026-03-08T18:38:36.690Z","repository":{"id":37799198,"uuid":"335882234","full_name":"ahmadnassri/action-workflow-run-wait","owner":"ahmadnassri","description":"wait for all `workflow_run` required workflows to be successful","archived":false,"fork":false,"pushed_at":"2022-12-30T15:01:14.000Z","size":80,"stargazers_count":38,"open_issues_count":7,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-30T17:12:21.690Z","etag":null,"topics":["action","github","workflow-run"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmadnassri.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-02-04T08:05:02.000Z","updated_at":"2024-10-11T09:49:37.000Z","dependencies_parsed_at":"2023-01-31T11:46:10.020Z","dependency_job_id":null,"html_url":"https://github.com/ahmadnassri/action-workflow-run-wait","commit_stats":{"total_commits":52,"total_committers":4,"mean_commits":13.0,"dds":"0.15384615384615385","last_synced_commit":"2aa3d9e1a12ecaaa9908e368eaf2123bb084323e"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadnassri%2Faction-workflow-run-wait","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadnassri%2Faction-workflow-run-wait/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadnassri%2Faction-workflow-run-wait/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadnassri%2Faction-workflow-run-wait/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmadnassri","download_url":"https://codeload.github.com/ahmadnassri/action-workflow-run-wait/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251748951,"owners_count":21637418,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["action","github","workflow-run"],"created_at":"2024-10-03T12:33:36.716Z","updated_at":"2026-03-08T18:38:36.647Z","avatar_url":"https://github.com/ahmadnassri.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Action: Workflow Run Wait\n\nwait for all `workflow_run` required workflows to be successful\n\n[![license][license-img]][license-url]\n[![release][release-img]][release-url]\n[![super linter][super-linter-img]][super-linter-url]\n[![test][test-img]][test-url]\n[![semantic][semantic-img]][semantic-url]\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eWhy?\u003c/strong\u003e\u003c/summary\u003e\n\nThe [`workflow_run`](https://docs.github.com/en/actions/reference/events-that-trigger-workflows#workflow_run) event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow.\n\n###### example\n\n``` yaml\non:\nworkflow_run:\n  workflows: [ test ]\n  types: \n    - completed\n```\n\nHowever by itself, this doesn't quite work as expected.\n\n1.  The `completed` type, does not indicate success, for that you'd have to include the following in each job of your workflow:\n\n    ``` yaml\n    if: ${{ github.event.workflow_run.conclusion == 'success' }}\n    ```\n\n2.  If you're depending on more than one workflow, then ANY of them completing, will trigger the event\n\n    ###### example\n\n    ``` yaml\n    name: deploy\n\n    on:\n    workflow_run:\n      workflows: [ test, lint, compile ]\n      types: \n        - completed\n    ```\n\n    \u003e *if your `test` workflow fails, but `lint` completed successfully, `github.event.workflow_run.conclusion == 'success'` will still be true*\n\n3.  Your workflow will trigger as many times as you have workflow dependencies\n\n        \u003e _in the previous example, our `deploy` workflow, will run 3 times!_\n\n    All this makes the `workflow_run` event fundamentally broken for any advanced usage, this Action aims to remedy that.\n\n    \u003e ***Note**: See this [Community discussion](https://github.community/t/workflow-run-completed-event-triggered-by-failed-workflow/128001/5) for more info on the topic*\n\n\u003c/details\u003e\n\n## Usage\n\n``` yaml\non:\n  workflow_run:\n    workflows: [ test-client, test-server ]\n    branches: [ master ]\n    types: [ completed ]\n\njobs:\n  xyz:\n    runs-on: ubuntu-latest\n\n    steps:\n      - uses: actions/checkout@v2\n      - uses: ahmadnassri/action-workflow-run-wait@v1\n\n      # only runs additional steps if [ test-client, test-server ] were successful\n```\n\n### Inputs\n\n| input              | required | default        | description                                     |\n|--------------------|----------|----------------|-------------------------------------------------|\n| `github-token`     | ❌        | `github.token` | The GitHub token used to call the GitHub API    |\n| `timeout`          | ❌        | `30000`        | timeout before we stop trying (in milliseconds) |\n| `delay`            | ❌        | `5000`         | delay between status checks (in milliseconds)   |\n| `sha`              | ❌        | `github.sha`   | Git SHA, if it's different from `github.sha`    |\n| `ignore-cancelled` | ❌        | `false`        | ignore cancelled workflow runs                  |\n\n----\n\u003e Author: [Ahmad Nassri](https://www.ahmadnassri.com/) \u0026bull;\n\u003e Twitter: [@AhmadNassri](https://twitter.com/AhmadNassri)\n\n[license-url]: LICENSE\n[license-img]: https://badgen.net/github/license/ahmadnassri/action-workflow-run-wait\n\n[release-url]: https://github.com/ahmadnassri/action-workflow-run-wait/releases\n[release-img]: https://badgen.net/github/release/ahmadnassri/action-workflow-run-wait\n\n[super-linter-url]: https://github.com/ahmadnassri/action-workflow-run-wait/actions?query=workflow%3Asuper-linter\n[super-linter-img]: https://github.com/ahmadnassri/action-workflow-run-wait/workflows/super-linter/badge.svg\n\n[test-url]: https://github.com/ahmadnassri/action-workflow-run-wait/actions?query=workflow%3Atest\n[test-img]: https://github.com/ahmadnassri/action-workflow-run-wait/workflows/test/badge.svg\n\n[semantic-url]: https://github.com/ahmadnassri/action-workflow-run-wait/actions?query=workflow%3Arelease\n[semantic-img]: https://badgen.net/badge/📦/semantically%20released/blue\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmadnassri%2Faction-workflow-run-wait","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmadnassri%2Faction-workflow-run-wait","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmadnassri%2Faction-workflow-run-wait/lists"}