Linear Advanced icon

Linear Advanced

Enhanced integration with Linear API
Join our community

Actions18

Overview

This node provides advanced integration with the Linear API, specifically enabling management of issues within Linear projects. The Update Issue operation allows users to modify existing issues by changing their title, description, priority, state, assignee, and labels.

Typical use cases include:

  • Updating issue details as project requirements evolve.
  • Changing issue priority or workflow state based on progress.
  • Reassigning issues to different team members.
  • Adding or removing labels to categorize issues better.

For example, a user can update an issue's title and description while also assigning it to a new team member and setting its priority to "High".

Properties

Name Meaning
Issue ID The unique identifier of the issue to update (required).
Title The new title for the issue (required).
Description The updated description of the issue in markdown format.
Additional Fields Optional fields to further customize the issue:
- Priority The priority level of the issue. Options: Urgent (1), High (2), Normal (3), Low (4).
- State ID The ID of the workflow state to assign the issue to.
- Assignee ID The ID of the user to whom the issue will be assigned.
- Label IDs Comma-separated list of label IDs to assign to the issue.

Output

The output is an array of JSON objects representing the updated issues. Each object contains all the properties of the updated issue as returned by the Linear API, including but not limited to:

  • id: The issue's unique identifier.
  • title: Updated title.
  • description: Updated description.
  • priority: Numeric priority value.
  • stateId: Current workflow state ID.
  • assigneeId: User ID of the assignee.
  • labelIds: Array of label IDs assigned to the issue.

No binary data is output by this node.

Dependencies

  • Requires an active connection to the Linear API via an API key credential configured in n8n.
  • Uses the official Linear SDK (@linear/sdk) to interact with the Linear API.
  • Proper permissions on the Linear workspace are necessary to update issues.

Troubleshooting

  • Missing Required Fields: If the Issue ID or Title is missing, the node will throw an error. Ensure these fields are provided.
  • Invalid Label IDs Format: Label IDs must be provided as a comma-separated string. Incorrect formatting may cause update failures.
  • API Authentication Errors: Invalid or expired API keys will prevent successful updates. Verify the API key credential configuration.
  • Permission Denied: The API key used must have sufficient permissions to update issues; otherwise, the operation will fail.
  • Network Issues: Connectivity problems with the Linear API endpoint can cause timeouts or errors.

If the node encounters an error during execution, it will either stop or continue based on the "Continue On Fail" setting, returning error details accordingly.

Links and References

Discussion