Plane icon

Plane

Consume Plane API

Overview

This node interacts with the Plane API to manage labels within a specified project. The "Label" resource with the "Get Many" operation retrieves all labels associated with a given project. This is useful for scenarios where you want to list or process all labels defined in a project, such as automating label-based workflows, reporting, or syncing labels with other systems.

Practical example:
You have a project management setup and want to fetch all labels used in a specific project to display them in a dashboard or use them to tag issues automatically in another tool.

Properties

Name Meaning
Project Name or ID The identifier of the project from which to retrieve labels. Choose from the dropdown or specify an ID using an expression.

Output

The output is a JSON array where each element represents a label object retrieved from the Plane API for the specified project. Each label object typically includes properties such as the label's unique ID, name, and possibly other metadata related to the label.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Plane API via an API key credential configured in n8n.
  • The node depends on the Plane API endpoints for projects and labels.
  • The "Project Name or ID" must be valid and accessible with the provided credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing project ID: Ensure the project ID is correct and that the API key has access to it.
    • Network or authentication errors: Verify API credentials and network connectivity.
    • Empty results: Confirm that the project actually contains labels.
  • Error messages:

    • Errors returned by the Plane API will be propagated. For example, "Not Found" if the project does not exist or "Unauthorized" if credentials are invalid.
    • If no labels are found, the output will be an empty array rather than an error.

Links and References

Discussion