Plane icon

Plane

Consume Plane API
Join our community

Actions63

Overview

This node interacts with the Plane API to manage issue property values within a project management context. Specifically, the "Add Values" operation under the "Issue Property Value" resource allows users to add one or more values to a specified issue property in a given project and issue.

Common scenarios for this node include:

  • Adding option selections or custom values to an issue's property to enrich issue metadata.
  • Automating updates of issue properties based on external triggers or workflows.
  • Managing complex issue attributes that require multiple selectable values (e.g., tags, categories).

For example, if you have an issue property representing "Priority Levels" with multiple options, you can use this node to add selected priority options to an issue programmatically.

Properties

Name Meaning
Project ID The unique identifier of the project containing the issue.
Issue ID The unique identifier of the issue to which the property value(s) will be added.
Property ID The unique identifier of the issue property to which values will be added.
Value The value(s) to add to the property. For properties of type OPTION, this should be a JSON array of option IDs; for other types, a single value is expected.

Output

The output of this operation is the response from the Plane API after adding the values to the specified issue property. It typically contains confirmation details about the updated property values.

The json output field will contain the API response object reflecting the newly added values.

This node does not handle binary data output.

Dependencies

  • Requires access to the Plane API via an authenticated API key credential configured in n8n.
  • The node depends on the Plane API endpoints related to projects, issues, and issue properties.
  • Proper permissions are needed on the Plane API side to modify issue property values.

Troubleshooting

  • Invalid Project/Issue/Property ID: Ensure that the provided IDs exist and belong to the same project context.
  • Incorrect Value Format: For OPTION-type properties, the value must be a valid JSON array of option IDs. For other types, provide a single value string. Malformed JSON or incorrect types may cause errors.
  • API Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Network or API Errors: Check network connectivity and Plane API status if requests fail unexpectedly.
  • Error Messages: The node may throw errors indicating missing required parameters or invalid input formats. Review error messages carefully and adjust inputs accordingly.

Links and References

Discussion