Planka icon

Planka

Interact with Planka API

Overview

The Delete Project operation for the 🏢 PROJECT resource in this n8n node allows you to permanently remove a project from your Planka workspace by specifying its unique Project ID. This is useful for automating project lifecycle management, cleaning up obsolete or test projects, or integrating Planka with other systems where project deletion needs to be triggered programmatically.

Practical examples:

  • Automatically delete demo or temporary projects after testing workflows.
  • Integrate with external systems (e.g., CRM, ticketing) to remove Planka projects when certain conditions are met.
  • Batch-delete multiple projects as part of a data cleanup process.

Properties

Name Type Meaning
Project ID String The ID of the project to be deleted. Required.

Output

  • On success, the output will contain a json field with the response from the Planka API after deleting the project. Typically, this may be an empty object or a confirmation message, depending on the API's behavior.
  • On error (if "Continue On Fail" is enabled), the output will include a json field with an error property containing the error message.

Example output on success:

[
  {
    "json": {}
  }
]

Example output on failure (with Continue On Fail):

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

Dependencies

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

Troubleshooting

Common issues:

  • Invalid Project ID: If the provided Project ID does not exist, the API will return an error such as "Project not found".
  • Insufficient Permissions: The API credentials used must have permission to delete projects; otherwise, you may receive a "Forbidden" or "Unauthorized" error.
  • Network/API Errors: Connectivity issues or incorrect API base URL configuration can result in request failures.

Error messages and resolutions:

  • "Project not found": Check that the Project ID is correct and exists in Planka.
  • "Unauthorized" or "Forbidden": Ensure your API credentials are valid and have sufficient permissions.
  • "An unknown error occurred": This is a generic fallback; check logs or API connectivity.

Links and References

Discussion