List GitHub issues | New Relic Documentation

Lists issues in a GitHub repository with optional filtering by state, labels, assignee, and milestone.

For authentication setup, see GitHub issue actions.

The following inputs are available for this action.

Input	Type	Description	Example
token	String	Required. GitHub Personal Access Token (fine-grained or classic) stored as a secret. Fine-grained PATs require Issues: Read and write 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"`
milestone	String	Optional. Filter by milestone. Pass a milestone number to filter by that milestone, `*` for issues with any milestone, or `none` for issues without a milestone.	`"1"` or `"*"` or `"none"`
state	String	Optional. Filter by issue state. Default: `open`. Allowed values: `open`, `closed`, `all`.	`"open"`
assignee	String	Optional. Filter by assignee username, `none` for unassigned issues, or `*` for issues assigned to any user.	`"octocat"`
type	String	Optional. Filter by issue type name, `*` for issues with any type, or `none` for issues without a type.	`"Bug"`
creator	String	Optional. Filter by the user that created the issue.	`"octocat"`
mentioned	String	Optional. Filter by a user mentioned in the issue.	`"octocat"`
labels	String	Optional. Comma-separated list of label names to filter by.	`"bug,incident"`
sort	String	Optional. Sort results by field. Default: `created`. Allowed values: `created`, `updated`, `comments`.	`"created"`
direction	String	Optional. Sort direction. Default: `desc`. Allowed values: `asc`, `desc`.	`"desc"`
since	String	Optional. Filter to issues last updated after this time. Must be an ISO 8601 timestamp: `YYYY-MM-DDTHH:MM:SSZ`.	`"2024-01-01T00:00:00Z"`
perPage	Int	Optional. Number of results per page (maximum 100). Default: `30`.	`30`
page	Int	Optional. Page number of the results to fetch. Default: `1`.	`1`
issueFieldValues	List	Optional. Issue field values for GitHub Projects v2 custom fields. Each object must include `field_id` (integer) and `value` (string, number, or array for multi-select fields). Only available for organization-owned repositories with GitHub Projects v2 custom fields enabled.	`[{"field_id": 1, "value": "high"}]`
selectors	List	Optional. JQ selectors to extract values from the response.	`[{"name": "firstIssueNumber", "expression": ".[0].number"}]`

This action returns the following outputs.

Output	Type	Example
response	Array	`[ { "id": 1, "number": 1347, "state": "open", "title": "Found a bug", "html_url": "https://github.com/octocat/Hello-World/issues/1347", "body": "I'm having a problem with this.", "created_at": "2011-04-22T13:33:48Z", "updated_at": "2011-04-22T13:33:48Z" } ]`
success	Boolean	`success: true \| false`
errorMessage	String	Contains the GitHub API error response body.

Output

Type

Example

response

Array

[
  {
    "id": 1,
    "number": 1347,
    "state": "open",
    "title": "Found a bug",
    "html_url": "https://github.com/octocat/Hello-World/issues/1347",
    "body": "I'm having a problem with this.",
    "created_at": "2011-04-22T13:33:48Z",
    "updated_at": "2011-04-22T13:33:48Z"
  }
]

success

Boolean

success: true | false

errorMessage

String

Contains the GitHub API error response body.

Workflow example
`name: github_list_issues_workflow description: List open GitHub issues steps: - name: list_issues type: action action: gitHub.issue.list version: 1 inputs: token: ${{ :secrets:github-PAT-token }} owner: your_user_name repo: test-workflow state: open assignee: your_user_name labels: "incident" sort: created direction: desc perPage: 30 page: 1 next: end`

Workflow example

name: github_list_issues_workflow
description: List open GitHub issues
steps:
  - name: list_issues
    type: action
    action: gitHub.issue.list
    version: 1
    inputs:
      token: ${{ :secrets:github-PAT-token }}
      owner: your_user_name
      repo: test-workflow
      state: open
      assignee: your_user_name
      labels: "incident"
      sort: created
      direction: desc
      perPage: 30
      page: 1
    next: end