OneDrive

---

OneDrive:Download File

Controlled node

Overview

Downloads a selected file from a connected Microsoft OneDrive account and imports it into the project library as a temporary file. Use this node when a workflow needs to pull a file from OneDrive before reading, processing, or transforming it inside Intellectible.

The node uses the panel UI to select a OneDrive connection and browse files. At runtime, it downloads the selected file, uploads it into the Intellectible library, removes the temporary local copy, and returns a library file object.

Connection Required

This node requires a configured OneDrive connection for the project. The connection selector only shows project connections with the ms-onedrive service.

Inputs

Input	Type	Description	Default
Run	Event	Triggers the download operation.	-
Source	Data	External file source selection. Configure this in the panel UI by selecting a OneDrive connection and file.	-

Outputs

Output	Type	Description
Done	Event	Fires when the node has finished running.
Output	Data	The downloaded temporary library file object. Returns null if the drive or file cannot be resolved.

Runtime Behavior and Defaults

• Controlled Node: The node runs only when the Run event fires.
• Project Requirement: A runtime project ID is required so the node can use the project connection and library.
• Connection Selection: The panel UI stores the selected OneDrive connection on the node.
• Drive Resolution: The runtime asks OneDrive for available drives and uses the first drive returned.
• File Selection: If a file list is available, the runtime downloads the first selected file. Otherwise it falls back to the file stored in the connection data.
• Temporary Library File: The downloaded file is uploaded as a temporary library file and output without the local filePath.
• Error Handling: If no drive or file ID is available, Output is set to null.

Example Usage

Download and Read a PDF

1. Add a OneDrive:Download File node.
2. In the panel UI, select the OneDrive connection and file.
3. Trigger Run from a Start node or another event.
4. Connect Output to Read PDF, Read Image, Read DOCX, or another file reader.

The node downloads the OneDrive file and returns a temporary library file reference for downstream nodes.

tip

Use Write To Library if you need to persist the downloaded temporary file in a specific library folder.

---

OneDrive:Upload File

Controlled node

Overview

Uploads workflow data to Microsoft OneDrive as a text file, CSV table, or Word document. Use this node when a workflow needs to push generated text, tabular results, or markdown-based reports into a OneDrive folder.

The node uses the panel UI to select a OneDrive connection, destination folder, file name, and file type.

Connection Required

This node requires a configured OneDrive connection for the project. The connection selector only shows project connections with the ms-onedrive service.

Inputs

Input	Type	Description	Default
Run	Event	Triggers the upload operation.	-
Data	Data	The content to upload. Text and DOCX uploads convert this value to text; CSV uploads accept a CSV string or structured tabular data.	-
File Name	Data	The name to give the uploaded file. The panel UI also stores this value on the node.	-

Properties

Property	Type	Description	Default
File Type	Select	The file format to upload: txt (Text File), csv (CSV Table), or docx (Word Document).	txt
Connection Source	Connection	The OneDrive connection used for upload.	-
Destination Folder	Folder picker	The OneDrive folder to upload into. If omitted, the runtime uploads to the root folder.	root

Outputs

Output	Type	Description
Done	Event	Fires when the node has finished running.
Output	Data	Boolean success flag. Returns true when OneDrive upload succeeds, otherwise false.

Runtime Behavior and Defaults

• Controlled Node: The node runs only when the Run event fires.
• Project Requirement: A runtime project ID is required so the node can use the project connection.
• Drive Resolution: The runtime asks OneDrive for available drives and uses the first drive returned.
• Folder Selection: The selected folder ID is read from connection data. If no folder is selected, the runtime uses root.
• Text Uploads: For txt, Data is converted to text and uploaded with MIME type text/plain.
• CSV Uploads: For csv, string data is uploaded directly. Non-string data is converted to CSV before upload.
• DOCX Uploads: For docx, Data is converted to text or markdown, rendered to DOCX, and uploaded as a Word document.
• Error Handling: If no OneDrive drive is available or upload does not return a file, Output is false.

Example Usage

Upload a Generated Report

1. Use AI Write or Markdown Text to produce report content.
2. Connect the generated content to Data.
3. Set File Name to "weekly-report".
4. In the panel UI, choose the OneDrive connection, destination folder, and docx file type.
5. Trigger Run from a Start node or another event.

The node uploads a Word document to OneDrive and outputs true when the upload succeeds.

tip

For files that should stay inside the Intellectible library instead of OneDrive, use Write Text File, Write CSV, or Write DOCX From Markdown.