Description

n8n-nodes-twakedrive

This is an n8n community node. It lets you use Twake Drive in your n8n workflows.

Twake Drive is an open source file sharing and storage platform focused on privacy and security. It’s built for efficient team collaboration with shared spaces, real-time editing, and seamless file organization. The Twake Drive app relies ont the Cozy stack API for permissions management and files operations.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Resources
Version history

Installation

• Go to Settings > Community Nodes
• Click Install a community node
• Enter n8n-nodes-twakedrive in the “Enter npm package name” field
• Acknowledge the risk: check “I understand the risks…”
• Click Install

Once installed, you can find it like any other node. Just search for “Twake Drive” in the node panel.

Or follow the installation guide in the n8n community nodes documentation.

Operations

List of all available operations in this node.

All operations provide a selectMode setting with two options:

• byDropdown: Displays a dynamic list that updates as you navigate through folders. Each selection refreshes the available children, allowing you to browse the tree. The final selected item is used by the operation.
• byId: A simple input where the user can paste a file or folder ID. The provided ID is used directly by the operation.

Files operations

• List files

– List all files in the specified folder
– Get a single file with it’s binary (download is now possible)

• Upload files

– Possibility to overwrite an already existing file

• Copy files
• Create file from text

– Possibility to overwrite an already existing file
– Possibility to save whether an io.cozy.notes or a .txt
– Content as Markdown supported for io.cozy.notes files

• Delete files
• Update files
• Move files
• Rename files

Folders operations

• Create Folder
• Delete Folder
• Move Folder
• Rename Folder

Shares operations

• Delete Share (by Permissions ID)

– Dynamic dropdown to select a permission ID

• Share by Link (File or Folder)

– With expiration possibility and password protection.

Different improvements (like dynamic lists when relevant on files and folders operations or Triggers operations) are planned for future updates.

Credentials

This node uses an OAuth 2.0 authentication.

> Note:
> For now, client creation is only possible via a cURL or HTTP request. See the tutorial below.

In both cases, the first step is to create a new credential in your n8n app. Select Twake Drive OAuth2 API in the list.
You must do this first, because you’ll need the OAuth Redirect URL shown in the credential setup window.

curl -X POST "https:///auth/register" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  --data-raw '{
    "redirecturis": ["REDIRECT_URL>"],
    "client_name": "n8n Twake Drive",
    "software_id": "github.com/cozy/n8n-nodes-twakedrive",
    "client_kind": "web"
  }'

#### CURL method

• Replace INSTANCE_URL with your instance domain (e.g https://example.mycozy.cloud or https://example.twake.linagora.com)
• Replace N8NREDIRECTURL with the OAuth Redirect URL you copied from the credentials setup window
• Send the modified cURL request in your terminal
• Copy both the clientid and the clientsecret from the response
• Paste those values into the appropriate fields in the credentials setup window
• Fill the remaining fields as shown in the examples under each field
• Connect to your instance

#### N8N node method

Doing it all in n8n is possible. Follow these steps:

• Replace INSTANCE_URL by your instance domain (e.g https://example.mycozy.cloud or https://example.twake.linagora.com)
• Replace N8NREDIRECTURL with the OAuth Redirect URL you copied from the credentials setup window
• Create a new workflow and add an HTTP Request node from n8n node search panel.
• Click Import cURL (currently located in the upper-right of the node panel).
• Paste the modified cURL request
• Execute the node
• Copy both the clientid and the clientsecret from the response
• Paste those values into the appropriate fields in the credentials setup window
• Fill the remaining fields as shown in the examples under each field
• Connect to your instance

Ta-da 🎉, you are now connected via OAuth2.

Client registration via the instance’s settings is on the way, coming very soon …

Compatibility

Tested with:

• Cozy Stack v1.6.39+
• n8n v1.0+

Resources

• n8n community nodes documentation

This is a community node. If you encounter issues or have feature requests, feel free to open an issue or PR on the GitHub repository.

Version history

1.6.0

• Updated the OAuth2 credentials: the authorization and access token URLs are now hidden and automatically generated from the configured instance URL, simplifying configuration.

1.5.0

• Introduce a shared twakeDriveRequest helper that wraps requestWithAuthentication with the correct OAuth2 options, and use it across all helpers and loaders. This allows the request to always refresh the token when it is expired so reconnect the credentials is no more needed. Thanks to Paul Tran-Van !

1.4.2

• Removed the “Codes” field from the UI and now enforce a fixed label internally in shareByLink, preventing permissions from being created without a usable share link.
• Removed the “Revoke only selected labels” logic in deleteShareByLink, since each share operation now produces a single share link per permission.

1.4.0

#### 🚨 Breaking changes

• Users can now choose, for all operations, whether to use a dynamic dropdown or paste an ID to select a file or folder. When using the dropdown for folders, the selected folder is used to request its children, allowing users to navigate through the tree structure. The list always keeps the direct parent and the root directory, so you can go back or move up the tree at any time. Nothing changes when using an ID: just paste the target ID directly.
• createFileFromText has been improved. Users can now choose to save a new file as io.cozy.notes or as a simple .txt file. In the case of a Cozy Note, markdown is supported for the file content.
• All operation return values (items OUT) are now the raw server response (data object), just like getFileFolder in the previous-to-last version (1.3.1). No more “embellishments”. This will affect existing workflows, as expression paths inside operations will no longer be the same.
• The token refresh issue appears to be resolved. We now rely on a specific HTTP status code that triggers n8n’s built-in token refresh mechanism. This behavior is not documented, but it seems to be supported in practice. We’ll monitor it to confirm its reliability. Thanks to b1zya for the insight.
• Full reorganisation of the project structure to make it easier to maintain and update. The project now has a significantly lighter TwakeDriveNode.node.ts file, with properties, descriptions and option loaders separated into dedicated directories.

1.3.2

• Ensure uploadFile operation return all input binaries

1.3.1

#### 🚨 Breaking changes

• getFileFolder return data structure has been changed. If you are using this operation in your workflow, you will need to make modifications accordingly

It was not meant to be pushed already, but this kind of changes will come in the future for every operations to harmonize returned items

• Little patch to fix the binary’s return on getFileFolder operation

1.3.0

#### 🚨 Breaking changes

• Finally getting the actual OAuth2 authentication for the node

You will no longer be able to run your workflow from v1.2.0 and under, authentication method has changed, all operation have been rebuilt accordingly

• Use requestWithAuthentication for all operations and load-options
• Standardize outputs: each operation returns a single top-level object named after the operation
• Add Rename File operation
• Files, Folder and Share operations: refactor, more robust JSON parsing and binary handling; clearer errors
• Load-options: permissions list fetched via authenticated requests with
• Add overwrite possibility in uploadFile if file with same name already exists

1.2.0

• Rename listFiles operation to getFileFolder and improve it

– Remove listAllFiles option as it was not revelant
– Remake the function to use two mode only : File and Folder. File mode will return a single file with it’s metadata and it’s binary. Folder will return the content of the specified folder, no binaries

• Remove getOneFile operation, as it is now handle by getFileFolder
• Sanitize instanceUrl input from credential to avoid trailing slashes
• Only one item return by operation, for UI clarity and usage
• Little modifications such as renaming some files or actions and descriptions for clearer UI

1.1.1

• Transfer repo ownership to Cozy Github organisation

1.1.0

• Using manual OAuth to get an app token instead of an admin token
• Folders operations (as listed above)
• Shares operations (as listed above)
• Add “byDirectory” option on listFiles operation
• Move ezlog (Little function to save an item during execution) in /utils folder for clarity
• Split operations in ressource categories in the n8n UI

1.0.0 – First release 🎉

• Connect via a locally generated token
• Files operations (as listed above)

Useful links

• Twake Drive website
• Twake Drive on GitHub
• Cozy Stack documentation
• Cozy stack on Github
• Twake Drive node on GitHub