Overview

This node adds labels to a specified GitHub issue. It is useful for automating issue management by categorizing issues with relevant labels, which helps in organizing and prioritizing tasks within a repository. For example, it can be used to automatically tag issues as 'bug', 'enhancement', or 'help wanted' based on certain triggers or workflows.

Use Case Examples

1. Automatically add a 'bug' label to new issues reported in a repository.
2. Tag issues with 'urgent' label when they meet specific criteria for priority handling.

Properties

Name	Meaning
Owner	Owner of the Issue Repository, used to identify the GitHub repository owner where the issue exists.
Repository	Repository of the Issue, specifies the repository name containing the issue to label.
Issue Number	Number of the targeted Issue, identifies the specific issue to which labels will be added.
Labels to Add	List of labels to add to the issue, allowing multiple labels to be specified for categorization.

Output

JSON

• json - The JSON output contains the response from GitHub API after adding labels to the issue, typically including updated issue details and labels.

Dependencies

• Requires OAuth2 API credentials for GitHub to authenticate and authorize the action.

Troubleshooting

• Ensure that the OAuth2 credentials are correctly configured and have the necessary permissions to modify issues in the repository.
• Verify that the owner, repository, and issue number are correctly specified to avoid 'not found' errors.
• Labels must exist in the repository or be valid new labels; otherwise, the API may reject the request.

Links

• GitHub API - Add Labels to an Issue - Official GitHub API documentation for adding labels to an issue, detailing required parameters and response structure.