Actions18
Overview
This node provides advanced integration with the Linear API, allowing users to interact programmatically with various Linear resources such as issues, comments, labels, members, projects, and teams. Specifically for the Label resource with the Get operation, the node retrieves detailed information about a specific label by its ID.
Common scenarios where this node is beneficial include:
- Fetching metadata or details of a particular label in Linear to use in workflows.
- Automating reporting or synchronization tasks that require label information.
- Integrating label data into other systems or dashboards.
For example, you might use this node to get the name, description, and color of a label identified by its ID, then use that data downstream in your automation workflow.
Properties
Name | Meaning |
---|---|
Label ID | The unique identifier of the label to retrieve. This is a required string input. |
Output
The node outputs JSON data representing the requested label object from Linear. The structure typically includes fields such as the label's ID, name, description, color, and any other metadata provided by the Linear API for labels.
Example output JSON (simplified):
{
"id": "label_id",
"name": "Bug",
"description": "Indicates a bug",
"color": "#ff0000"
}
No binary data output is involved in this operation.
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 communicate with the Linear API. - The node expects valid credentials and network access to Linear's services.
Troubleshooting
- Missing or invalid Label ID: If the Label ID is not provided or incorrect, the node will fail to retrieve the label. Ensure the Label ID is correct and exists in your Linear workspace.
- API authentication errors: If the API key credential is missing, expired, or invalid, the node will throw authentication errors. Verify your API key configuration.
- Network or API downtime: Temporary connectivity issues or Linear API outages can cause failures. Retry after some time or check Linear's status page.
- Error messages: Errors thrown by the node will generally indicate the problem, e.g., "Label ID is required" or "Label not found." Use these messages to adjust inputs accordingly.
Links and References
- Linear API Documentation
- Linear SDK on npm
- n8n Documentation (for general Linear node usage)