Actions18
Overview
This node provides advanced integration with the Linear API, enabling various operations on Linear resources such as issues, comments, labels, members, projects, and teams. Specifically for the Issue resource and the Add Label operation, the node allows you to add a label to an existing issue by specifying the issue ID and the label ID.
Common scenarios where this node is beneficial include automating issue management workflows, such as tagging issues with specific labels based on external triggers or conditions in your automation workflows. For example, when a new bug report is created in another system, you can automatically add a "bug" label to the corresponding issue in Linear.
Properties
| Name | Meaning |
|---|---|
| Issue ID | The unique identifier of the issue to which the label will be added. |
| Label ID | The unique identifier of the label that will be added to the specified issue. |
Output
The output JSON object for the Add Label operation contains:
success: A boolean indicating whether the label was successfully added.issueId: The ID of the issue that was updated.labelId: The ID of the label that was added.
Example output JSON:
{
"success": true,
"issueId": "ISSUE_ID_VALUE",
"labelId": "LABEL_ID_VALUE"
}
No binary data is output by this operation.
Dependencies
- Requires an active connection to the Linear API using an API key credential.
- The node uses the official Linear SDK (
@linear/sdk) to interact with the Linear API. - Proper configuration of the Linear API credentials in n8n is necessary.
Troubleshooting
Common Issues:
- Providing invalid or non-existent Issue ID or Label ID will cause the operation to fail.
- Network connectivity issues or invalid API keys will prevent successful API calls.
Error Messages:
- If the issue or label IDs are missing or incorrect, the node may throw errors related to resource not found.
- If the API key credential is missing or invalid, authentication errors will occur.
- The node throws a specific error if the "addComment" operation is attempted, as it is currently not supported.
Resolution Tips:
- Verify that the Issue ID and Label ID exist in your Linear workspace.
- Ensure the API key credential is correctly set up and has sufficient permissions.
- Use the supported operations only; for adding comments, use alternative supported methods.