github_actions_list_workflow_runs
Retrieve a filtered list of GitHub Actions workflow runs for a specified workflow. Filter by status, branch, event, or actor to monitor CI/CD pipelines.
Instructions
List workflow runs for a workflow
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | Yes | owner | |
| repo | Yes | repo | |
| workflow_id | Yes | workflow_id | |
| actor | No | Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. | |
| branch | No | Returns workflow runs associated with a branch. Use the name of the branch of the `push`. | |
| event | No | Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. For more information, see "[Events that trigger workflows](https://docs.github.com/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows)." | |
| status | No | Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status can be `in_progress`. Only GitHub Actions can set a status of `waiting`, `pending`, or `requested`. | |
| per_page | No | The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)." | |
| page | No | The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)." | |
| created | No | Returns workflow runs created within the given date-time range. For more information on the syntax, see "[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates)." | |
| exclude_pull_requests | No | If `true` pull requests are omitted from the response (empty array). | |
| check_suite_id | No | Returns workflow runs with the `check_suite_id` that you specify. | |
| head_sha | No | Only returns workflow runs that are associated with the specified `head_sha`. |