Plane icon

Plane

Consume Plane API
Join our community

Actions63

Overview

This node interacts with the Plane API to manage labels within projects. Specifically, the "Label" resource with the "Get" operation retrieves detailed information about a specific label in a given project. This is useful for workflows that need to fetch metadata or properties of labels used for categorizing or tagging issues, tasks, or other entities within a project management context.

Practical examples include:

  • Automatically retrieving label details to enrich issue data before processing.
  • Synchronizing label information between Plane and other tools.
  • Validating label existence or properties before performing further operations.

Properties

Name Meaning
Project Name or ID The identifier of the project containing the label. Choose from a list of available projects or specify an ID using an expression.
Label Name or ID The identifier of the label to retrieve. Depends on the selected project. Choose from a list of labels within the project or specify an ID using an expression.

Output

The output JSON contains the full details of the requested label as returned by the Plane API. This typically includes fields such as the label's ID, name, description, color, creation date, and any other metadata associated with the label.

No binary data output is involved in this operation.

Dependencies

  • Requires an active Plane API credential configured in n8n to authenticate requests.
  • The node depends on the Plane API service being accessible.
  • The node uses internal helper functions to make HTTP requests to the Plane API endpoints.

Troubleshooting

  • Common Issues:

    • Providing an invalid or non-existent project ID or label ID will result in errors or empty responses.
    • Network connectivity issues or incorrect API credentials can cause authentication failures.
    • If the label list for the specified project is large, loading options might be slow.

  • Error Messages:

    • Errors related to "label not found" indicate the label ID does not exist in the specified project.
    • Authentication errors suggest misconfigured or missing API credentials.
    • "No binary data exists on item!" or similar messages do not apply to this operation but may appear if mistakenly used with binary inputs.

  • Resolutions:

    • Verify the project and label IDs are correct and exist in Plane.
    • Ensure the API key or token is valid and has sufficient permissions.
    • Use expressions carefully to dynamically set IDs.

Links and References

Discussion