Planka icon

Planka

Interact with Planka API

Overview

The 🗑️ Delete Board List operation for the 📋 BOARD resource in this n8n node allows you to permanently delete a specific list from a board in Planka, a project management tool. This is useful when you want to clean up or reorganize your boards by removing lists that are no longer needed.

Common scenarios:

  • Removing obsolete or completed lists from a board.
  • Automating board maintenance as part of workflow clean-up.
  • Integrating with other automation steps (e.g., archiving cards before deleting a list).

Practical example:
You might use this operation at the end of a sprint to automatically remove all "Done" lists from multiple boards after archiving their cards.


Properties

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

Output

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

Example success output:

{}

Example error output (with Continue On Fail):

{
  "error": "List 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 List ID: If the provided List ID does not exist, the API will return an error such as "List not found".
  • Insufficient Permissions: The user associated with the API key must have permission to delete lists on the target board.
  • Network/API Errors: Connectivity issues or incorrect API base URL can cause failures.

Error messages and resolutions:

  • "List not found": Double-check the List ID; ensure it exists and is correct.
  • "Unauthorized" or "Forbidden": Verify that the API credentials are correct and have sufficient permissions.
  • "An unknown error occurred": Check network connectivity and review the full error message for more details.

Links and References


Discussion