JoplinInstall

Overview

This node allows you to delete a Note from your Joplin instance using the Joplin API. It is useful in workflows where you need to automate the removal of notes, such as cleaning up outdated information, managing note lifecycles, or integrating with other systems that require note deletion as part of a process.

Example scenarios:

• Automatically deleting notes after they have been processed or archived.
• Removing notes based on external triggers (e.g., when a related task is completed).
• Cleaning up test or temporary notes created during automated processes.

Properties

Name	Type	Meaning
Note	resourceLocator	The ID of the Note to delete. You can select from a list, provide a Joplin note URL, or enter the Note ID.

Details:

• Note: This property supports multiple modes for specifying the note:
  • List: Select a note from a searchable list.
  • By URL: Paste a Joplin note URL (must match the required format).
  • ID: Enter the 32-character Note ID directly.

Output

• The output will be an array containing the original input item(s).
• For each deleted note, the output does not include additional data about the deleted note; it simply returns the input item structure, indicating successful processing.
• If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output (success):

[
  {
    "json": {
      // original input fields
    }
  }
]

Example output (failure, with Continue On Fail):

[
  {
    "json": {
      "error": "Not a valid Joplin Note ID"
    }
  }
]

Dependencies

• Joplin API: Requires access to a running Joplin instance with the Web API enabled.
• Credentials: You must configure the jApi credential in n8n, which includes:
  • baseUrl: The base URL of your Joplin API.
  • token: Your Joplin API token.

Troubleshooting

Common issues:

• Invalid Note ID or URL: If the provided Note ID or URL does not match the expected format, the node will throw an error such as "Not a valid Joplin Note ID".
  • Resolution: Double-check the Note ID or ensure the URL matches the pattern joplin://x-callback-url/openNote?id=XXXXXXXX....
• Authentication errors: If credentials are missing or incorrect, the node will fail to connect to the Joplin API.
  • Resolution: Verify your jApi credentials in n8n.
• Note not found: If the specified note does not exist, the Joplin API may return an error.
  • Resolution: Ensure the Note ID is correct and the note exists in your Joplin instance.

Links and References

• Joplin API Documentation
• n8n Credentials Documentation
• Joplin Official Website