> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# actions_list_jobs_for_run

> List a run's jobs, each with its conclusion and its failing steps named. This is what turns 'the run failed' into 'the `pytest` step of the `test` job failed', usually without reading a log at all.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://api.github.com/repos/{owner}/{repo}/actions/runs/{runId}/jobs"}</code></div>

```python github_actions_list_jobs_for_run.py theme={null}
from charter.packs import github

result = await github.actions_list_jobs_for_run.ainvoke({"owner": ..., "repo": ..., "runId": ...})
```

<Note>
  Requires `repo`, `read:user`. Pages by number: `page` with `per_page`.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                         | Type      | Description                                                                              |
  | ------------------------------------------------------------- | --------- | ---------------------------------------------------------------------------------------- |
  | `owner` <span className="required" title="required">\*</span> | `string`  | The account owner of the repository. The name is not case sensitive.                     |
  | `repo` <span className="required" title="required">\*</span>  | `string`  | The name of the repository without the `.git` extension. The name is not case sensitive. |
  | `runId` <span className="required" title="required">\*</span> | `integer` | The ID of the workflow run.                                                              |
</div>

## Query parameters

<div className="reference-table">
  | Field     | Type                                                         | Description                                                                                                                                                                                                                                                       |
  | --------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `perPage` | `integer`                                                    | The number of results per page (max 100). Defaults to 30. <span className="field-constraints">≥ 1; ≤ 100; defaults to `30`</span>                                                                                                                                 |
  | `page`    | `integer`                                                    | The page number of the results to fetch. Defaults to 1. <span className="field-constraints">≥ 1; defaults to `1`</span>                                                                                                                                           |
  | `filter`  | [JobFilter](/charter/charter/packs/github/actions/objects#jobfilter) | Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution of the workflow run. `all` returns all jobs for a workflow run, including from old executions of the workflow run. GitHub uses `latest` when this is absent. |
</div>