LinearEnhanced icon

LinearEnhanced

Consume Linear API

Actions5

Overview

The LinearEnhanced node for n8n allows you to interact with the Linear API, specifically to retrieve multiple issues from your Linear workspace. The "Issue: Get Many" operation fetches a list of issues, either all available or up to a specified limit. This is useful for automating workflows that require bulk issue data, such as reporting, synchronization with other tools, or batch processing.

Practical examples:

  • Fetching all open issues in a project for reporting.
  • Syncing issues from Linear to another system (e.g., Jira, Trello).
  • Triggering notifications or actions based on the current backlog.

Properties

Name Meaning
Authentication Selects the authentication method. Options: API Token
Return All Whether to return all results or only up to a given limit
Limit Max number of results to return (only shown if "Return All" is false; minimum value: 1)

Output

The output is an array of JSON objects, each representing an issue retrieved from Linear. Each object contains the fields provided by the Linear API for an issue, such as:

[
  {
    "id": "string",
    "title": "string",
    "description": "string",
    // ...other issue fields as returned by Linear
  }
]
  • If an error occurs and "Continue On Fail" is enabled, the output will include an object like:
    { "error": "Error message text" }
    

Dependencies

  • External Service: Requires access to the Linear API.
  • API Key: You must provide a valid Linear API token via n8n credentials (linearEnhancedApi).

Troubleshooting

  • Authentication Errors:
    • Error: "The security token included in the request is invalid"
      Solution: Check that your API token is correct and has sufficient permissions.
  • Rate Limits:
    • If too many requests are made, the Linear API may throttle or reject requests. Consider using pagination or limiting the number of items.
  • Missing Data:
    • If no issues are returned, verify your Linear workspace contains issues and your API token has access to them.

Links and References

Discussion