List GitHub workflow runs | New Relic Documentation

Lists GitHub Actions workflow runs for a repository, with optional filtering by workflow, branch, event, status, and more. If workflowId is provided, the list is scoped to that specific workflow; otherwise it returns runs across all workflows in the repository.

For authentication setup, see GitHub workflow run actions.

The following inputs are available for this action.

Input	Type	Description	Example
token	String	Required. GitHub Personal Access Token stored as a secret. Fine-grained PATs require Actions: read permission. Classic PATs require repo scope.	`"${{ :secrets:github-PAT-token }}"`
owner	String	Required. The account owner of the repository (user or organization login). Case-insensitive.	`"octocat"`
repo	String	Required. Repository name without the .git suffix. Case-insensitive.	`"Hello-World"`
workflowId	String	Optional. The workflow file name (for example, `deploy.yml`) or numeric workflow ID. When provided, only runs for that workflow are returned.	`"deploy.yml"`
branch	String	Optional. Filter by branch name.	`"main"`
event	String	Optional. Filter by triggering event type.	`"workflow_dispatch"`
status	String	Optional. Filter by run status or conclusion. Allowed values: `completed`, `action_required`, `cancelled`, `failure`, `neutral`, `skipped`, `stale`, `success`, `timed_out`, `in_progress`, `queued`, `requested`, `waiting`, `pending`.	`"completed"`
actor	String	Optional. Filter by the GitHub login of the user who triggered the workflow.	`"octocat"`
headSHA	String	Optional. Only return runs with this specific head commit SHA.	`"5cd968b93ae41f708cd094303e80bd4fca09d980"`
resultsPerPage	Int	Optional. Number of results per page (1–100). Default: `30`.	`10`
page	Int	Optional. Page number of results to fetch. Default: `1`.	`1`
created	String	Optional. Filter by creation date using GitHub's date range syntax.	`">=2026-09-01"` or `"2026-09-01..2026-09-17"`
excludePullRequests	Boolean	Optional. If `true`, pull request information is omitted from the response. Default: `false`.	`false`
checkSuiteId	Int	Optional. Filter by the ID of the associated check suite.	`12345`
selectors	List	Optional. JQ selectors to extract values from the response. Runs are in `.workflow_runs[]`. Common selectors: `.total_count`, `.workflow_runs[0].id`, `.workflow_runs[0].conclusion`.	`[{"name": "latestRunId", "expression": ".workflow_runs[0].id"}]`

This action returns the following outputs.

Output	Type	Example
response	Object	`{ "total_count": 27, "workflow_runs": [ { "id": 35064429580, "name": "Deploy to staging", "status": "completed", "conclusion": "success", "html_url": "https://github.com/owner/repo/actions/runs/35064429580", "run_number": 15, "event": "workflow_dispatch", "head_branch": "main", "created_at": "2026-09-16T06:35:42Z", "updated_at": "2026-09-16T06:35:50Z" } ] }`
success	Boolean	`success: true \| false`
errorMessage	String	Contains the GitHub API error response body.

Output

Type

Example

response

Object

{
  "total_count": 27,
  "workflow_runs": [
    {
      "id": 35064429580,
      "name": "Deploy to staging",
      "status": "completed",
      "conclusion": "success",
      "html_url": "https://github.com/owner/repo/actions/runs/35064429580",
      "run_number": 15,
      "event": "workflow_dispatch",
      "head_branch": "main",
      "created_at": "2026-09-16T06:35:42Z",
      "updated_at": "2026-09-16T06:35:50Z"
    }
  ]
}

success

Boolean

success: true | false

errorMessage

String

Contains the GitHub API error response body.

Workflow example
name: list_workflow_runs description: List GitHub Actions workflow runs for a specific workflow steps: - name: list_runs type: action action: gitHub.workflowRun.list version: 1 inputs: token: ${{ :secrets:github-PAT-token }} owner: your_user_name repo: test-workflow workflowId: deploy.yml branch: main status: completed resultsPerPage: 10 selectors: - name: totalCount expression: ".total_count" - name: latestRunId expression: ".workflow_runs[0].id" - name: latestConclusion expression: ".workflow_runs[0].conclusion" next: end

Workflow example

name: list_workflow_runs
description: List GitHub Actions workflow runs for a specific workflow
steps:
  - name: list_runs
    type: action
    action: gitHub.workflowRun.list
    version: 1
    inputs:
      token: ${{ :secrets:github-PAT-token }}
      owner: your_user_name
      repo: test-workflow
      workflowId: deploy.yml
      branch: main
      status: completed
      resultsPerPage: 10
      selectors:
        - name: totalCount
          expression: ".total_count"
        - name: latestRunId
          expression: ".workflow_runs[0].id"
        - name: latestConclusion
          expression: ".workflow_runs[0].conclusion"
    next: end