Planka icon

Planka

Interact with Planka API

Overview

The 🗑️ Delete Attachment operation for the 📝 CARD resource in this n8n node allows you to permanently remove an attachment from a card in Planka, a project management platform. This is useful when you need to automate the cleanup of files or ensure that outdated or incorrect attachments are deleted as part of your workflow.

Practical scenarios:

  • Automatically removing sensitive documents after processing.
  • Cleaning up temporary files attached to cards.
  • Enforcing file retention policies within project boards.

Properties

Name Type Meaning
Attachment ID String The unique identifier of the attachment to be deleted from the card. This is required to specify which attachment should be removed.

Output

The output will be a JSON object reflecting the response from the Planka API after attempting to delete the specified attachment. Typically, for a successful deletion, the response may be empty or contain a confirmation message. If an error occurs, and "Continue On Fail" is enabled, the output will include an error field with the error message.

Example output on success:

{}

Example output on failure (with Continue On Fail):

{
  "error": "Attachment not found"
}

Dependencies

  • Planka API: Requires access to a running Planka instance.
  • API Credentials: You must configure the plankaApi credentials in n8n for authentication.
  • n8n Configuration: No special environment variables are needed beyond standard credential setup.

Troubleshooting

Common issues:

  • Invalid Attachment ID: If the provided Attachment ID does not exist, the API will return an error such as "Attachment not found".
  • Insufficient Permissions: The user associated with the API credentials must have permission to delete attachments on the target card.
  • Network/API Errors: Connectivity issues or misconfigured API endpoints can result in errors like "Could not connect to Planka API".

Error messages and resolutions:

  • "Attachment not found": Double-check the Attachment ID; ensure it exists and is correct.
  • "Unauthorized" or "Forbidden": Verify that your API credentials are valid and have sufficient permissions.
  • "An unknown error occurred": This is a generic fallback; check the n8n logs and Planka server logs for more details.

Links and References

Discussion