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.1.0.0 - Added eager startup and lazy continuation for list invokes.
0.0.0.15 - Aligned the V2 connector contract and public help article.
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 OAuthConnection lock handling.
0.0.0.12 - Template overhaul.
0.0.0.13 - Node name correction.
| Property |
Type |
Description |
Tenant Id |
String |
The Azure Active Directory 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.
| 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 do not append default mutation fields to returned rows or objects.
ListDrives and ListItems retrieve their first Microsoft Graph page while the Node invoke is awaited. They follow @odata.nextLink only as the Workflow consumes later 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.