Linear AdvancedInstall

Overview

This node provides advanced integration with the Linear API, enabling automation and management of various Linear resources such as issues, comments, labels, members, projects, and teams. Specifically for the Issue resource and the Add Comment operation, the node is designed to add a markdown-formatted comment to an existing issue in Linear.

However, based on the current implementation, the Add Comment operation for the Issue resource is not available and will throw an error instructing users to use a different operation. This suggests that while the node supports many operations on issues, adding comments directly via this operation is disabled or pending implementation.

Typical use cases for this node include:

• Automating issue creation, updates, and retrieval in Linear.
• Managing issue labels and comments programmatically.
• Integrating Linear issue tracking into broader workflows, such as syncing with other tools or triggering notifications.

Practical example (if Add Comment were supported):

• Automatically add a comment to a Linear issue when a related event occurs in another system, e.g., a customer support ticket update.

Properties

Output

The output of the node is a JSON object representing the result of the operation. For the Add Comment operation (if it were implemented), this would typically include details about the newly created comment, such as its ID, body content, author, timestamps, and associated issue ID.

Since the Add Comment operation is currently unavailable, no successful output is produced for this operation. Other operations on issues return JSON objects representing issues or confirmation of label additions.

The node does not output binary data.

Dependencies

• Requires an API key credential for authenticating with the Linear API.
• Uses the official @linear/sdk package to interact with Linear's API.
• Requires proper configuration of the Linear API credentials within n8n.

Troubleshooting

• Operation Not Available Error:
  When attempting to use the "Add Comment" operation on the "Issue" resource, the node throws an error:
  "The addComment operation is currently not available. Please use a different operation."
  This indicates that this specific operation is not implemented in the node. To work around this, consider using other supported operations or check if the "Comment" resource with its own create operation can fulfill your needs.

• Invalid Input Errors:
  If required properties like "Issue ID" or "Comment Body" are missing or empty, the node may fail. Ensure all required fields are correctly set.

• API Authentication Errors:
  If the API key credential is invalid or missing, the node will fail to connect to Linear. Verify that the API key is correct and has sufficient permissions.

• JSON Parameter Errors (for JSON Request resource):
  When using JSON parameters, invalid JSON or missing required fields will cause errors. Validate JSON syntax and required fields before execution.

Links and References

• Linear API Documentation
• @linear/sdk GitHub Repository
• n8n Documentation - Creating Custom Nodes