Plane icon

Plane

Consume Plane API

Overview

This node interacts with the Plane API to manage issue attachments within a project management context. Specifically, for the Issue Attachment resource and the Get Many operation, it retrieves all attachments associated with a specific issue in a given project.

Common scenarios where this node is beneficial include:

  • Automating retrieval of all files or documents attached to an issue for reporting or processing.
  • Integrating issue attachments into workflows that require access to related files, such as sending attachments via email or syncing them with other storage services.
  • Auditing or backing up attachments linked to issues in a project.

Example use case: You have a project tracking system where each issue can have multiple attachments (screenshots, logs, documents). Using this node, you can fetch all attachments for a particular issue automatically and then process or archive them elsewhere.

Properties

Name Meaning
Project ID The unique identifier of the project containing the issue.
Issue ID The unique identifier of the issue whose attachments you want to retrieve.

Output

The output is a JSON array where each element represents an attachment object related to the specified issue. Each attachment object typically includes metadata such as attachment ID, filename, URL, size, content type, creation date, and possibly other relevant details provided by the Plane API.

If the node supports binary data output for attachments (not explicitly shown for Get Many), it would represent the actual file content or a reference to it. However, for the "Get Many" operation, the output mainly consists of metadata about each attachment.

Dependencies

  • Requires an active connection to the Plane API using an API key credential configured in n8n.
  • The node depends on the Plane API endpoints for projects, issues, and attachments.
  • No additional external services are required beyond the Plane API.

Troubleshooting

  • Missing or invalid Project ID / Issue ID: Ensure that both IDs are correctly provided and correspond to existing entities in your Plane workspace.
  • API authentication errors: Verify that the API key credential is valid and has sufficient permissions to access project and issue data.
  • No attachments found: If the issue has no attachments, the output will be an empty array; confirm that attachments exist for the issue.
  • Network or API errors: Check network connectivity and Plane API status if requests fail unexpectedly.
  • Binary data errors (for upload operations): When uploading attachments, ensure the binary property name matches the input data and that binary data exists on the input item.

Links and References


This summary focuses exclusively on the Issue Attachment - Get Many operation based on the provided source code and properties.

Discussion