List issues
- Updated: 2026/05/12
The List issues action retrieves all issues from a GitHub repository based on the specified filters.
Overview
The List issues action retrieves the issues based on issue state, labels, and assignee. The action requires an active GitHub session to authenticate the request. The retrieved data includes the issue ID, title, description, state, HTML URL, user, created date, assignee, and labels.
Settings
The List issues action contains the following settings:
Note: All the input fields support string variables. You can
create a string variable to hold the appropriate text string
and select it in the applicable setting and option.
- Session name
- Specifies the GitHub session name that the
Connect action creates. Use one of the following
options to specify the session name:
- Session name: Enter the session name as text directly or select the string variable that holds the session name text.
- Variable: Select the GitHub session variable that the Connect action creates.
- Owner name
- Specifies the name of the GitHub repository owner. The owner can be an organization or a user account. You can either enter the name directly as text or select the applicable string variable.
- Repository name
- Specifies the name of the GitHub repository from which the action retrieves the issues. You can either enter the repository name directly as text or select the applicable string variable.
- State
- Specifies the state of the issues to retrieve. Select one of the following options:
- Open: Select to retrieve all open issues. This is the default selection.
- Closed: Select to retrieve all closed issues.
- All: Select to retrieve all issues regardless of their state.
- Labels (optional)
- Specifies the labels to filter the issues. You can either enter the labels directly as text or select the applicable string variable. You can specify multiple labels using comma-separated values. The action retrieves only the issues that contain the labels specified in this field.
- Assignee (optional)
- Specifies the username of the assignee to filter the issues. You can either enter the assignee username directly as text or select the applicable string variable. You can specify multiple assignees using comma-separated values. The action retrieves only the issues that the users specified in this field are assigned to.
- Assign output to variable
- Specifies the table variable in which the action stores the response data. The
response data includes the following fields:
id- The unique identifier of the issue.issueNumber- The unique identifier of the issue within the repository.title- The title of the issue.body- The body text of the issue.state- The state of the issue.htmlURL- The HTML URL of the issue.user- The user who created the issue.createdAt- The timestamp indicating when the issue was created.assignee- The user assigned to the issue.labels- The labels that are added to the issue.