LinearEnhanced icon

LinearEnhanced

Consume Linear API
Join our community

Actions5

Overview

The LinearEnhanced node for n8n allows you to interact with the Linear API, specifically to update existing issues. This is useful in automated workflows where you need to modify issue details such as assignee, description, priority, state, team, title, or due date based on triggers or other data.

Common scenarios:

  • Automatically updating issue status when a related task is completed.
  • Changing assignees or priorities based on external events.
  • Modifying issue descriptions or due dates from another system.

Example:
When a support ticket is escalated in your helpdesk, use this node to update the corresponding Linear issue's priority and assign it to a senior engineer.

Properties

Name Meaning
Authentication Select the authentication method. Only "API Token" is supported.
Issue ID The unique identifier of the issue you want to update. (Required)
Update Fields A collection of fields to update on the issue. You can set one or more of the following:
  Assignee Name or ID Assign the issue to a user by selecting from a list or specifying an ID/expression.
  Description New description text for the issue.
  Priority Name/ID Set the issue's priority. Options: Urgent, High, Medium, Low, No Priority.
  State Name or ID Change the workflow state by selecting from a list or specifying an ID/expression.
  Team Name or ID Move the issue to a different team by selecting from a list or specifying an ID/expression.
  Title Update the issue's title.
  Due Date Set or change the due date for the issue.

Output

  • The output is a JSON object representing the updated issue as returned by the Linear API.
  • If an error occurs and "Continue On Fail" is enabled, the output will be a JSON object containing an error field with the error message.

Example output:

{
  "id": "12345",
  "title": "Updated Issue Title",
  "description": "New description",
  "assigneeId": "user_abc",
  "priority": 2,
  "stateId": "state_xyz",
  "teamId": "team_def",
  "dueDate": "2024-07-01"
}

Note: Actual fields depend on the Linear API response.

Dependencies

  • External Service: Requires access to the Linear API.
  • API Key: You must provide a valid Linear API token via n8n credentials (linearEnhancedApi).
  • n8n Configuration: Ensure the credential is set up and selected in the node.

Troubleshooting

Common Issues:

  • Invalid API Token:
    Error: "The security token included in the request is invalid"
    Resolution: Check that your API token is correct and has sufficient permissions.

  • Missing Required Field:
    Error: "issueId is required"
    Resolution: Make sure you provide a valid Issue ID.

  • Field Value Errors:
    Error messages may occur if you supply invalid IDs or values for fields like assignee, state, or team.
    Resolution: Use the provided dropdowns or ensure IDs are correct.

  • Network/API Errors:
    Any connectivity or API errors will be reported in the output if "Continue On Fail" is enabled.

Links and References

Discussion