Plane icon

Plane

Consume Plane API

Overview

This node interacts with the Plane API to manage labels within projects. Specifically, the "Label" resource with the "Delete" operation allows users to delete a label from a specified project by providing the project ID and the label ID. This is useful for cleaning up or removing obsolete or incorrect labels in project management workflows.

Common scenarios include:

  • Automating cleanup of labels that are no longer relevant.
  • Managing project metadata dynamically based on changing requirements.
  • Integrating label deletion into larger automation workflows involving issue tracking or project updates.

Example: Automatically remove a deprecated label from a project when certain conditions are met in your workflow.

Properties

Name Meaning
Project Name or ID The identifier of the project from which the label will be deleted. Choose from a list or use an expression.
Label Name or ID The identifier of the label to delete within the selected project. Choose from a list or use an expression.

Output

The output JSON contains the response from the Plane API after attempting to delete the label. Typically, this will be an empty object or confirmation of successful deletion. If the deletion fails, the output may contain error information.

No binary data 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 user must have appropriate permissions to delete labels in the specified project.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent project ID or label ID will cause the deletion to fail.
    • Insufficient permissions on the Plane API side can result in authorization errors.
    • Network or connectivity issues may prevent the API call from succeeding.
  • Error messages:

    • Errors returned from the Plane API will be passed through, such as "Label not found" or "Unauthorized".
    • If the label does not exist in the specified project, expect a "not found" type error.
    • To resolve, verify the project and label IDs, ensure correct API credentials, and check user permissions.

Links and References

Discussion