Plane icon

Plane

Consume Plane API

Overview

This node interacts with the Plane API to manage issue properties within a project management context. Specifically, for the "Issue Property" resource and the "Delete" operation, it deletes a specified property from an issue type in a given project.

Use cases include automating cleanup or modification of issue metadata by removing obsolete or incorrect custom properties associated with issue types. For example, if a project has an issue type with a custom property that is no longer needed, this node can delete that property programmatically.

Properties

Name Meaning
Project ID The unique identifier of the project containing the issue type whose property will be deleted.
Issue Type ID The unique identifier of the issue type within the project where the property exists.
Property ID The unique identifier of the issue property to delete.

Output

The output JSON contains the response from the Plane API after attempting to delete the specified issue property. Typically, for a delete operation, this may be an empty object or confirmation of deletion. No binary data output is involved.

Dependencies

  • Requires an active connection to the Plane API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The node uses internal helper functions to make HTTP requests to the Plane API endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing Project ID, Issue Type ID, or Property ID parameters will cause the API call to fail.
    • Insufficient permissions or invalid API credentials will result in authorization errors.
    • Attempting to delete a non-existent property will likely return a not found error.
  • Error messages:

    • Errors returned from the Plane API are propagated. Typical messages might include "Property not found" or "Unauthorized".
    • If the node throws an error about missing binary data, it indicates a misconfiguration unrelated to this operation (since delete does not use binary data).
  • Resolution:

    • Verify all IDs are correct and correspond to existing resources.
    • Ensure the API key credential is valid and has sufficient permissions.
    • Use the "Get All" operations to list available projects, issue types, and properties to confirm identifiers before deletion.

Links and References

Discussion