Joplin icon

Joplin

Consume Joplin API

Actions9

Folder → Delete

AI-generated

Overview

This node allows you to delete a folder from your Joplin account using the Joplin API. It is useful in workflows where you need to automate the management of folders, such as cleaning up old or unused folders, or integrating Joplin with other systems that require dynamic folder organization.

Practical examples:

  • Automatically remove project folders in Joplin when a project is archived in another system.
  • Clean up empty or temporary folders on a schedule.
  • Integrate with ticketing systems to delete folders related to closed tickets.

Properties

Name Type Meaning
Folder Name or ID options ID of the folder to delete. You can select from a list of existing folders or specify an ID using an expression. This is required.

Output

  • The output will be an array of items, each containing a json field.
  • For each input item, the output's json object will have a property:
    • res: Contains the response from the Joplin API after attempting to delete the folder. The structure of this response depends on the Joplin API but typically includes status information about the deletion operation.

Example output:

[
  {
    "json": {
      "res": { /* Joplin API response for folder deletion */ }
    }
  }
]

Dependencies

  • External Service: Requires access to a Joplin server with its API enabled.
  • Credentials: You must configure n8n with valid Joplin API credentials (jApi), including the base URL and token.
  • n8n Configuration: Ensure the Joplin credential is set up in n8n under Credentials.

Troubleshooting

Common issues:

  • Invalid Folder ID: If the provided folder ID does not exist, the node may throw an error indicating the folder was not found.
  • Authentication Errors: If the Joplin API credentials are incorrect or expired, you may receive authentication or authorization errors.
  • API Connectivity: Network issues or incorrect base URL configuration can prevent the node from reaching the Joplin API.

Error messages and resolutions:

  • "error": "Request failed with status code 404"
    Resolution: Check that the Folder Name or ID is correct and exists in your Joplin account.
  • "error": "Unauthorized"
    Resolution: Verify your Joplin API credentials (base URL and token) in n8n.
  • "error": "Network Error"
    Resolution: Ensure the Joplin server is reachable from your n8n instance and the base URL is correct.

Links and References

Discussion