actions_list_runs_for_workflow - Charter Docs

GET

github_actions_list_runs_for_workflow.py

import asyncio

from charter.packs import github

result = asyncio.run(github.actions_list_runs_for_workflow.ainvoke({"owner": ..., "repo": ..., "workflowId": ...}))

Requires repo. With github.APP or github.FINE_GRAINED, requires actions=read or actions=write. Pages by number: page with per_page.

Path parameters

Field	Type	Description
`owner` *	`string`	The account owner of the repository. The name is not case sensitive.
`repo` *	`string`	The name of the repository without the `.git` extension. The name is not case sensitive.
`workflowId` *	`integer` \| `string`	The ID of the workflow. You can also pass the workflow file name as a string, such as `ci.yml`, which is usually the one you have.

Query parameters

Field	Type	Description
`perPage`	`integer`	The number of results per page (max 100). Defaults to 30. ≥ 1; ≤ 100; defaults to `30`
`page`	`integer`	The page number of the results to fetch. Defaults to 1. ≥ 1; defaults to `1`
`actor`	`string`	Returns someone’s workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run.
`branch`	`string`	Returns workflow runs associated with a branch. Use the name of the branch of the `push`.
`event`	`string`	Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`.
`status`	WorkflowRunStatusFilter	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`.
`created`	`string`	Returns workflow runs created within the given date-time range, in GitHub’s search syntax: ’>=2026-01-01’ or ‘2026-01-01..2026-02-01’.
`excludePullRequests`	`boolean`	If `true` pull requests are omitted from the response (empty array).
`checkSuiteId`	`integer`	Returns workflow runs with the `check_suite_id` that you specify.
`headSha`	`string`	Only returns workflow runs that are associated with the specified `head_sha`.