Microsoft OneDrive

Integrate with OneDrive through Microsoft Graph.

Revision History

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

Parameter	Type	Description
Tenant Id	String	Entra ID tenant identifier (or common for multi-tenant).
Client Id	String	Application (client) ID registered in Entra ID.
Client Secret	Masked	Client secret generated for the app registration.
Access Token	Masked	OAuth access token (populated after Connect your Account authorization).
Refresh Token	Masked	OAuth refresh token (populated when returned by Microsoft).
Scopes	String	OAuth scopes requested during authorization (default: offline_access Files.ReadWrite.All).

Setup Notes

1. Register an application in Entra ID (Azure AD) with application permissions under Microsoft Graph: Files.ReadWrite.All, Sites.ReadWrite.All and User.Read.
2. Grant admin consent for the selected permissions or ensure the signed-in user has consented.
3. Configure the connection with Tenant Id, Client Id, Client Secret, and Scopes as offline_access Files.ReadWrite.All.

Methods

ListDrives

Parameter	Type	Notes
Connection	Connection	OAuth connection containing Graph credentials.

Return	Type	Notes
Drives	Array	List of drives with relevant info for each drive.

GetDrive

Parameter	Type	Notes
Connection	Connection	OAuth connection containing Graph credentials.
DriveId	String	Optional identifier of the drive to retrieve. Must be provided if no Drive Name given.
DriveName	String	Optional name of the drive to retrieve. Must be provided if no Drive Id given.

Return	Type	Notes
Drive	Object	Drive object returned.

ListItems

Parameter	Type	Notes
Connection	Connection	OAuth connection containing Graph credentials.
DriveId	String	Optional identifier of the drive to retrieve. Must be provided if no Drive Name given.
DriveName	String	Optional name of the drive to retrieve. Must be provided if no Drive Id given.
ParentItemId	String	Optional identifier of the folder to list. Defaults to the root folder when omitted.
ParentItemName	String	Optional name of the folder to list. Defaults to the root folder when omitted.

Return	Type	Notes
Items	Array	List of items with relevant info for each item.

CreateFolder

Parameter	Type	Notes
Connection	Connection	OAuth connection containing Graph credentials.
DriveId	String	Optional identifier of the drive to retrieve. Must be provided if no Drive Name given.
DriveName	String	Optional name of the drive to retrieve. Must be provided if no Drive Id given.
ParentItemId	String	Optional identifier of the containing folder. Defaults to the root folder when omitted.
ParentItemName	String	Optional name of the containing folder. Defaults to the root folder when omitted.
Name	String	Required name for the new folder to create.

Return	Type	Notes
Item	Object	Item object info for the newly created folder.

UploadItem

Parameter	Type	Notes
Connection	Connection	OAuth connection containing Graph credentials.
DriveId	String	Optional identifier of the drive to retrieve. Must be provided if no Drive Name given.
DriveName	String	Optional name of the drive to retrieve. Must be provided if no Drive Id given.
ParentItemId	String	Optional identifier of the containing folder. Defaults to the root folder when omitted.
ParentItemName	String	Optional name of the containing folder. Defaults to the root folder when omitted.
Content	Stream	Required stream content of the file to upload.
ContentFileName	String	Required name for the file to be uploaded.

Return	Type	Notes
Item	Object	Item object info for the uploaded file.

RenameItem

Parameter	Type	Notes
Connection	Connection	OAuth connection containing Graph credentials.
DriveId	String	Optional identifier of the drive to retrieve. Must be provided if no Drive Name given.
DriveName	String	Optional name of the drive to retrieve. Must be provided if no Drive Id given.
ItemId	String	Optional identifier of the item to rename. Must be provided if no Item Name given.
ItemName	String	Optional name of the item to rename. Must be provided if no Item Id given.
ParentItemId	String	Optional identifier of the containing folder. Defaults to the root folder when omitted.
ParentItemName	String	Optional name of the containing folder. Defaults to the root folder when omitted.
NewName	String	Required new name for the file.

Return	Type	Notes
Item	Object	Item object info for the renamed file.

DownloadFile

Parameter	Type	Notes
Connection	Connection	OAuth connection containing Graph credentials.
DriveId	String	Optional identifier of the drive to retrieve. Must be provided if no Drive Name given.
DriveName	String	Optional name of the drive to retrieve. Must be provided if no Drive Id given.
ItemId	String	Optional identifier of the item to download. Must be provided if no Item Name given.
ItemName	String	Optional name of the item to download. Must be provided if no Item Id given.
ParentItemId	String	Optional identifier of the containing folder. Defaults to the root folder when omitted.
ParentItemName	String	Optional name of the containing folder. Defaults to the root folder when omitted.

Return	Type	Notes
Content	Stream	Stream content of file to download.

Usage Notes

• The templates will populate the parameters with data from the primary folder as well as providing a blank option for custom requests.
• For each parameter, either the Id or Name can be provided. The templates populate both fields as this data is available from the Connection.