Microsoft OneDrive

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.

Revision History

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.

Connection

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.

Setup Notes

  1. Register an application in Entra ID that can access Microsoft Graph for OneDrive operations.
  2. Grant the Microsoft Graph permissions required for your OneDrive scenario.
  3. Configure the Flowgear Connection with Tenant Id, Client Id, Client Secret, and Scopes.
  4. Test the Connection before using the Node in a Workflow.

Methods

ListDrives

Parameter Type Description
Connection Connection OAuth connection containing Microsoft Graph credentials.
Return Type Description
Drives Array The available drives for the authenticated user.

GetDrive

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.

ListItems

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.

CreateFolder

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.

UploadItem

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.

RenameItem

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.

DownloadFile

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.

Usage Notes

  • 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.