Planka icon

Planka

Interact with Planka API

Overview

The 🗑️ Delete Board Label operation for the 📋 BOARD resource in this n8n node allows you to permanently remove a label from a board in Planka, a project management tool. This is useful when you want to clean up unused or obsolete labels from your boards to keep your workspace organized.

Common scenarios:

  • Removing outdated or redundant labels from a board.
  • Automating board maintenance tasks as part of a workflow (e.g., after archiving cards with a certain label, delete the label itself).
  • Keeping the labeling system consistent by removing labels that are no longer needed.

Practical example:
You have an automation that, at the end of each sprint, removes all "Sprint X" labels from your board. This operation can be used to delete those labels programmatically.


Properties

Name Type Meaning
Label ID String The unique identifier of the board label to be deleted. Required.

Output

  • The output will be a JSON object representing the response from the Planka API after attempting to delete the label.
  • 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 success output:

{}

Example error output (with Continue On Fail):

{
  "error": "Label 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 Label ID: If the provided Label ID does not exist, the API will likely return a "not found" error.
  • Insufficient Permissions: The user associated with the API credentials must have permission to delete labels on the specified board.
  • Network/API Errors: Connectivity issues or incorrect API base URL configuration can cause failures.

Error messages and resolutions:

  • "Label not found": Double-check the Label ID; ensure it exists and is correct.
  • "Unauthorized" or "Forbidden": Verify that the API credentials have sufficient permissions.
  • "An unknown error occurred": Check network connectivity and review the full error message in n8n's execution logs.

Links and References


Discussion