v5

latestSwagger 2.0MIT2026-08-03485217850.7 KB
repository

List runs for a workflow

get/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs

Path parameters

ownerstring required

owner of the repo

repostring required

name of the repo

workflow_idstring required

id of the workflow, must be the workflow file name (e.g. build.yml)

Query parameters

eventstring

workflow event name

branchstring

workflow branch

statusstring

workflow status (pending, queued, in_progress, failure, success, skipped)

actorstring

triggered by user

head_shastring

triggering sha of the workflow run

exclude_pull_requestsboolean

if true, the pull_requests field on each returned run is emptied

scoped_workflow_source_repo_idinteger

For a scoped workflow, the ID of the source repository providing it; omit or 0 for a repo-level workflow.

pageinteger

page number of results to return (1-based)

limitinteger

page size of results

Response

WorkflowRunsList

total_countinteger