Planka

Overview

The 🗑️ Delete Board operation for the 📋 BOARD resource in this n8n node allows users to permanently delete a board from their Planka workspace via the Planka API. This is useful for automating the cleanup of boards that are no longer needed, integrating board lifecycle management into workflows, or ensuring data hygiene by removing obsolete project boards.

Practical scenarios:

• Automatically deleting temporary boards after a project phase is completed.
• Integrating with other systems to remove boards when a related entity (e.g., a project or client) is archived or deleted.
• Scheduled clean-up of unused boards as part of regular maintenance workflows.

Properties

Name	Type	Meaning
Board ID	String	The unique identifier of the board to be deleted. Required to specify which board will be removed from Planka.

Output

• The output will be a JSON object reflecting the response from the Planka API after attempting to delete the specified board.
• If successful, the response may be empty or contain confirmation details depending on the API's implementation.
• 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:

[{}]

or

[
  {
    "json": {}
  }
]

Example output on failure (with Continue On Fail):

[
  {
    "json": {
      "error": "Board not found"
    }
  }
]

Dependencies

• External Service: Requires access to a running Planka instance with API enabled.
• Authentication: Needs valid Planka API credentials configured in n8n under the credential type plankaApi.
• n8n Configuration: No special environment variables required beyond standard credential setup.

Troubleshooting

Common Issues:

• Invalid Board ID: If the provided Board ID does not exist, the API will return an error such as "Board not found".
• Insufficient Permissions: The user associated with the API credentials must have permission to delete the board; otherwise, an authorization error will occur.
• Network/API Errors: Connectivity issues or incorrect API base URL configuration can cause failures.

Error Messages & Resolutions:

• "Board not found": Check that the Board ID is correct and exists in your Planka instance.
• "Unauthorized" or "Forbidden": Ensure the API credentials have sufficient permissions.
• "An unknown error occurred": Indicates an unexpected issue; check network connectivity and review logs for more details.

Links and References

• Planka GitHub Repository
• n8n Documentation: Custom Nodes
• Planka API Reference (if available)

---

Summary:
This operation provides a straightforward way to automate the deletion of boards in Planka through n8n, requiring only the Board ID as input and handling errors gracefully if configured.