Joplin icon

Joplin

Consume Joplin API

Actions9

Folder → Update

AI-generated

Overview

The Joplin n8n node allows you to interact with the Joplin API, specifically for managing folders, notes, tags, and attachments.
For the Folder → Update operation, this node updates properties of an existing folder in your Joplin account.
Typical use cases include:

  • Renaming a folder.
  • Changing a folder's parent (moving it within the hierarchy).
  • Assigning the folder to a different user or updating metadata.

Example:
You might use this node in a workflow that automatically organizes notes by moving folders based on certain criteria, or when synchronizing folder structures between systems.

Properties

Name Type Meaning
Folder Name or ID options The ID of the folder to update. Select from a list or specify via expression.
Update Fields collection Fields to update in the folder. Add one or more of the following:
  Title string New title for the folder.
  Parent Name or ID options ID of the new parent folder. Select from a list or specify via expression.
  User_created_time options ID of the user to assign the folder to. (May depend on project context.)
  User_updated_time number Reason why the folder is blocked. Requires "Is Blocked" toggle to be enabled.

Output

  • The output is a JSON object under the field res containing the updated folder's data as returned by the Joplin API.
  • Example output structure:
{
  "res": {
    "id": "string",
    "parent_id": "string",
    "title": "string",
    // ...other folder fields as provided by Joplin API
  }
}

Dependencies

  • External Service: Requires access to a Joplin server with its API enabled.
  • Credentials: You must configure the jApi credential in n8n, which includes:
    • baseUrl: The base URL of your Joplin API endpoint.
    • token: Your Joplin API token.

Troubleshooting

Common Issues:

  • Invalid Folder ID: If the specified folder does not exist, the API will return an error.
  • Missing Credentials: If the jApi credentials are not set up correctly, authentication will fail.
  • Insufficient Permissions: The API token must have permission to update folders.

Error Messages:

  • "Cannot read property 'update' of undefined": Likely due to misconfigured credentials or unreachable Joplin API.
    • Resolution: Check your Joplin API URL and token in the n8n credentials.
  • "Folder not found": The folder ID provided does not exist.
    • Resolution: Double-check the folder selection or ID.

Links and References

Discussion