Microsoft OneDrive is a cloud file storage and collaboration platform that lets users store, organize, share, and retrieve files and folders through the Microsoft Graph API.
The Flowgear Microsoft OneDrive Node lets you list drives and items, retrieve drive details, create folders, upload files, rename items, and download file content from a Workflow. Use it when you need Flowgear to move files into or out of OneDrive or automate folder-level file operations.
0.0.0.1 - Initial release.
0.0.0.2 - Added support for non seekable streams.
0.0.0.3 - Improved parameter descriptions for AI systems.
0.0.0.4 - Fixed shared Connection lock handling.
0.0.0.12 - Template overhaul.
0.0.0.13 - Node name correction.
0.0.0.15 - Maintenance release.
0.1.0.0 - List methods now retrieve the first page before returning and load later pages as the Workflow consumes rows.
0.1.0.2 - Maintenance release.
The Microsoft OneDrive Connection uses OAuth to authenticate with Microsoft Graph.
| Property |
Type |
Description |
Tenant Id |
String |
The Microsoft Entra ID tenant identifier, or common for multi-tenant sign-in. |
Client Id |
String |
The application client identifier registered in Entra ID. |
Client Secret |
Masked |
The application client secret generated in Entra ID. |
Access Token |
Masked |
OAuth access token returned by Microsoft Graph. |
Refresh Token |
Masked |
OAuth refresh token returned by Microsoft Graph. |
Scopes |
String |
The OAuth scopes requested during authorization. The default is offline_access Files.ReadWrite.All. |
- Register an application in Entra ID that can access Microsoft Graph for OneDrive operations.
- Grant the Microsoft Graph permissions required for your OneDrive scenario.
- Configure the Flowgear Connection with
Tenant Id, Client Id, Client Secret, and Scopes.
- Test the Connection before using the Node in a Workflow.
This Node exposes methods to list and retrieve drives, list folder contents, create folders, upload files, rename items, and download file content.
| Parameter |
Type |
Description |
Connection |
Connection |
OAuth connection containing Microsoft Graph credentials. |
| Return |
Type |
Description |
Drives |
Array |
The available drives for the authenticated user. |
| Parameter |
Type |
Description |
Connection |
Connection |
OAuth connection containing Microsoft Graph credentials. |
DriveId |
String |
Identifier of the drive to retrieve. Use this or DriveName. |
DriveName |
String |
Name of the drive to retrieve. Use this or DriveId. |
| Return |
Type |
Description |
Drive |
Object |
The resolved drive details. |
| Parameter |
Type |
Description |
Connection |
Connection |
OAuth connection containing Microsoft Graph credentials. |
DriveId |
String |
Identifier of the drive containing the folder. Use this or DriveName. |
DriveName |
String |
Name of the drive containing the folder. Use this or DriveId. |
ParentItemId |
String |
Parent folder identifier. If omitted, the Node uses the root folder. |
ParentItemName |
String |
Parent folder name. If omitted, the Node uses the root folder. |
| Return |
Type |
Description |
Items |
Array |
The items found in the resolved folder. |
| Parameter |
Type |
Description |
Connection |
Connection |
OAuth connection containing Microsoft Graph credentials. |
DriveId |
String |
Identifier of the drive containing the parent folder. Use this or DriveName. |
DriveName |
String |
Name of the drive containing the parent folder. Use this or DriveId. |
ParentItemId |
String |
Parent folder identifier. If omitted, the Node uses the root folder. |
ParentItemName |
String |
Parent folder name. If omitted, the Node uses the root folder. |
Name |
String |
The name of the folder to create. |
| Return |
Type |
Description |
Item |
Object |
The created folder item. |
Flowgear |
Object |
Default mutation fields containing IsSuccess and Message. |
| Parameter |
Type |
Description |
Connection |
Connection |
OAuth connection containing Microsoft Graph credentials. |
DriveId |
String |
Identifier of the drive containing the parent folder. Use this or DriveName. |
DriveName |
String |
Name of the drive containing the parent folder. Use this or DriveId. |
ParentItemId |
String |
Parent folder identifier. If omitted, the Node uses the root folder. |
ParentItemName |
String |
Parent folder name. If omitted, the Node uses the root folder. |
Content |
Stream |
The file content to upload. |
ContentFileName |
String |
The file name to assign to the uploaded content. |
| Return |
Type |
Description |
Item |
Object |
The uploaded drive item. |
Flowgear |
Object |
Default mutation fields containing IsSuccess and Message. |
| Parameter |
Type |
Description |
Connection |
Connection |
OAuth connection containing Microsoft Graph credentials. |
DriveId |
String |
Identifier of the drive containing the item. Use this or DriveName. |
DriveName |
String |
Name of the drive containing the item. Use this or DriveId. |
ItemId |
String |
Identifier of the item to rename. Use this or ItemName. |
ItemName |
String |
Name of the item to rename. Use this or ItemId. |
ParentItemId |
String |
Parent folder identifier. If omitted, the Node uses the root folder. |
ParentItemName |
String |
Parent folder name. If omitted, the Node uses the root folder. |
NewName |
String |
The new name for the item. |
| Return |
Type |
Description |
Item |
Object |
The renamed drive item. |
Flowgear |
Object |
Default mutation fields containing IsSuccess and Message. |
| Parameter |
Type |
Description |
Connection |
Connection |
OAuth connection containing Microsoft Graph credentials. |
DriveId |
String |
Identifier of the drive containing the item. Use this or DriveName. |
DriveName |
String |
Name of the drive containing the item. Use this or DriveId. |
ItemId |
String |
Identifier of the item to download. Use this or ItemName. |
ItemName |
String |
Name of the item to download. Use this or ItemId. |
ParentItemId |
String |
Parent folder identifier. If omitted, the Node uses the root folder. |
ParentItemName |
String |
Parent folder name. If omitted, the Node uses the root folder. |
| Return |
Type |
Description |
Content |
Stream |
The downloaded file stream. |
- Query and read methods return OneDrive data without adding
Flowgear response metadata.
ListDrives and ListItems retrieve their first Microsoft Graph page before returning, and retrieve later pages only as the Workflow consumes rows.- If the first provider call for a list method fails, that Microsoft Graph error surfaces before downstream enumeration begins.
- Templates include drive-aware defaults and a custom option so you can keep the detected drive but choose your own folder or item values.
- For drive and item selection, you can supply either the identifier or the name.
CreateFolder, UploadItem, and RenameItem preserve the returned OneDrive item payload and add Flowgear mutation metadata under Flowgear.