Planka icon

Planka

Interact with Planka API

Overview

The 🗑️ Delete User operation in the Planka n8n node allows you to permanently remove a user from your Planka instance by specifying their User ID. This is useful for automating user management tasks, such as cleaning up accounts of former employees or users who no longer require access.

Practical scenarios:

  • Automatically deprovisioning users when they leave an organization.
  • Integrating with HR or IT systems to keep user lists synchronized.
  • Removing test or inactive accounts as part of regular maintenance workflows.

Properties

Name Type Meaning
User ID String The unique identifier of the user to delete. This value must be provided and corresponds to the user you wish to remove from Planka.

Output

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

Example output (success):

{
  "json": {}
}

Example output (failure):

{
  "json": {
    "error": "User not found"
  }
}

Dependencies

  • Planka API: You must have a running Planka instance accessible via HTTP(S).
  • API Credentials: The node requires valid Planka API credentials configured in n8n under the name plankaApi.

Troubleshooting

Common issues:

  • Invalid User ID: If the specified User ID does not exist, the API will likely return an error such as "User not found".
  • Insufficient Permissions: The API credentials used must have permission to delete users; otherwise, you may receive a "Forbidden" or "Unauthorized" error.
  • Network/Connection Errors: Ensure that n8n can reach your Planka instance and that the API URL is correct.

Error messages and resolutions:

  • "User not found": Double-check the User ID for typos or confirm the user exists.
  • "Unauthorized" or "Forbidden": Verify your API credentials and permissions.
  • "An unknown error occurred": Check network connectivity and review the Planka server logs for more details.

Links and References

Discussion