Skip to main content
OneDrive logo
  • Category: file management & storage
  • Auth: OAUTH2, S2S_OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 102
  • Triggers: 9
  • Slug: ONE_DRIVE
  • Version: 20261101_00

Frequently Asked Questions

Items in “Shared” may be references to files stored in SharePoint, not actual files in the user’s OneDrive. These references can’t be downloaded via OneDrive endpoints.To fix this, open the file’s location in OneDrive or SharePoint, choose “Copy to” then “My files” to create a copy in the user’s OneDrive, and download the copy. If you need programmatic access to SharePoint files, use the SharePoint APIs instead.

Tools

Slug: ONE_DRIVE_ADD_WORKBOOK_WORKSHEETAdds a new worksheet to an existing Excel workbook in OneDrive or SharePoint. The worksheet is created with the specified name and appended to the end of the workbook’s worksheet collection. Use this action when you need to create a new sheet in an Excel file to organize data, add reports, or separate information into logical sections.

Input Parameters

string
Optional name for the new worksheet. If omitted, Excel determines the worksheet name. If a worksheet with this name already exists, the API will return an error.
string
required
The unique identifier of the workbook item (Excel file) where the worksheet will be added. Must be a valid driveItem ID for an Excel workbook. Obtain from ONE_DRIVE_LIST_FOLDER_CHILDREN, ONE_DRIVE_SEARCH_ITEMS, or similar operations.
string
required
The unique identifier of the drive containing the workbook. Obtain from ONE_DRIVE_LIST_DRIVES or similar operations.
string
Optional workbook session ID. Use this to add the worksheet in an existing Excel workbook session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CALCULATE_WORKBOOKRecalculate formulas in an Excel workbook at the requested depth.

Input Parameters

string
required
DriveItem ID of the Office Open XML workbook to recalculate.
string
required
Drive containing the workbook. Use ‘me’ for the connected user’s drive, or provide a Microsoft Graph drive ID.
string
Optional workbook session ID to recalculate inside an existing Excel workbook session, so session-local edits are included.
string ("Recalculate" | "Full" | "FullRebuild")
required
Calculation depth: Recalculate recalculates dirty cells, Full recalculates all formulas, and FullRebuild also rebuilds dependencies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CHECKIN_ITEMTool to check in a checked out driveItem resource, making the version of the document available to others. Use when you need to check in a file that was previously checked out in OneDrive or SharePoint.

Input Parameters

string
A check-in comment that is associated with the version.
string
required
The unique identifier of the drive containing the item to check in.
string
Optional. The status of the document after the check-in operation is complete. Can be ‘published’ or unspecified.
string
required
The unique identifier of the driveItem to check in.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CHECKOUT_ITEMTool to check out a driveItem to prevent others from editing it and make your changes invisible until checked in. Use when you need to lock a file for exclusive editing in SharePoint or OneDrive.

Input Parameters

string
required
The unique identifier of the drive containing the item to checkout.
string
required
The unique identifier of the driveItem (file or folder) to checkout.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CLEAR_WORKBOOK_RANGEClears values, formats, or both from a worksheet range in an Excel workbook stored in OneDrive or SharePoint without deleting cells or shifting neighboring data. Use this action when you need to reset a range while preserving the worksheet’s cell structure.

Input Parameters

string
required
The range address in A1 notation to clear without deleting cells or shifting surrounding data.
string
required
The DriveItem ID of the Excel workbook whose worksheet range should be cleared.
string ("All" | "Formats" | "Contents")
The part of a workbook range to clear.
string
required
The unique identifier of the drive containing the workbook. Use ‘me’ for the authenticated user’s default OneDrive, or provide a OneDrive/SharePoint drive ID.
string
Optional workbook session ID to send in the workbook-session-id header.
string
required
The ID or name of the worksheet that contains the range to clear. Names with spaces or special characters are URL-encoded automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CLOSE_WORKBOOK_SESSIONClose an Excel workbook session without deleting the workbook.

Input Parameters

string
required
DriveItem ID of the workbook whose session is being closed.
string
Drive containing the workbook. Use ‘me’ for the connected user’s drive, or provide a Microsoft Graph drive ID.
string
required
Workbook session ID returned by ONE_DRIVE_CREATE_WORKBOOK_SESSION.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_COPY_ITEMCopies a DriveItem file or folder, optionally renaming it or specifying a destination folder. Copy requests may be asynchronous; a monitor URL is returned when supplied by the service, and an accepted request does not mean the copy is complete.

Input Parameters

string
The new name for the copied item. If not provided, the same name as the original is used. Recommended to provide either ‘name’ or ‘parent_reference’ for reliable operation.
string
required
The ID of the DriveItem to be copied.
string
The ID of the site if the item is in a SharePoint site.
string
The ID of the user if accessing another user’s drive.
string
The ID of the drive where the item is located. If not provided, ‘me’ (user’s default drive) is assumed.
string
The ID of the group if the item is in a group drive.
boolean
If set to true, only the children of the source driveItem (if it’s a folder) are copied, not the driveItem itself. Defaults to false. Cannot be used with name parameter.
object
Reference to the parent item (folder) where the copy will be created. If not provided, the item is copied to the same location. Recommended to provide either ‘name’ or ‘parent_reference’ for reliable operation. Must use stable OneDrive item IDs (not paths or names), as paths break on rename/relocation. Resolve names/paths first using ONE_DRIVE_SEARCH_ITEMS or ONE_DRIVE_ONEDRIVE_FIND_FOLDER. Expected keys: driveId and id.
string ("fail" | "replace" | "rename")
Specifies how to handle a naming conflict if an item with the same name already exists in the destination. ‘fail’ (default), ‘replace’, or ‘rename’.
boolean
If set to true, the version history of the source file is copied to the destination. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CREATE_ITEM_PERMISSIONTool to create a new permission on a OneDrive drive item. Use when you need to grant application or SharePoint group permissions to a file or folder. This endpoint supports creating application permissions and SharePoint site group permissions only.

Input Parameters

array
required
Array of Microsoft Graph role strings to assign to the permission. Documented/common values include read, write, and owner for SharePoint/OneDrive for Business permission resources; tenant/resource-specific roles may also be accepted by Graph.
string
required
The unique identifier of the drive.
string
required
The unique identifier of the drive item.
object
required
The identity to grant permission to. Must contain either application or siteGroup property.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CREATE_SHAREPOINT_LIST_ITEMCreate an item in a SharePoint list using Microsoft Graph through the OneDrive connection. Use when you need to add a new row/item to a SharePoint list after resolving the site ID and list ID.

Input Parameters

object
required
Field values for the new list item, keyed by SharePoint internal column name. For a basic custom list, include at least {‘Title’: ‘New item’}.
string
required
The unique Microsoft Graph ID of the SharePoint list where the item will be created. Use ONE_DRIVE_LIST_SITE_LISTS to find list IDs.
string
required
The Microsoft Graph SharePoint site ID in composite format, usually ‘hostname,site-collection-id,web-id’. Use ONE_DRIVE_GET_SITE_DETAILS or ONE_DRIVE_LIST_SITE_LISTS outputs to confirm the site ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CREATE_UPLOAD_SESSIONCreate only a resumable upload session for a named file; this action does not upload bytes. It returns a short-lived preauthenticated uploadUrl for an external fragment uploader. Keep the URL secret and do not send an Authorization header to it.

Input Parameters

string
Drive ID. Omit to use the connected user’s drive.
string
required
Name of the file the upload session will create.
integer
Optional total file size in bytes. This property is supported by OneDrive Personal.
string
Optional file description. This property is supported by OneDrive Personal.
boolean
Whether uploading all fragments requires a separate explicit commit.
string
Only create the session when the target resource matches this ETag.
string
required
Parent folder DriveItem ID. Use ‘root’ for the drive root.
string ("rename" | "fail" | "replace")
Behavior when an item with the target name already exists.
string
Only create the session when the target resource does not match this ETag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CREATE_UPLOAD_SESSION_BY_PATHCreate only a resumable upload session at a root-relative path; this action does not upload bytes. It returns a short-lived preauthenticated uploadUrl for an external fragment uploader. Keep the URL secret and do not send an Authorization header to it.

Input Parameters

string
Drive ID. Omit to use the connected user’s drive.
integer
Optional total file size in bytes for an early quota check. This property is supported by OneDrive Personal.
string
Optional file description. This property is supported by OneDrive Personal.
boolean
Whether uploading all fragments requires a separate explicit commit.
object
Optional media-source metadata for OneDrive for Business or SharePoint.
string
Only create the session when the target resource matches this ETag.
string
required
Root-relative path including the destination file name. Use ’/’ between path segments and do not include a leading slash.
object
File system information on client.
string ("rename" | "fail" | "replace")
Behavior when an item with the target name already exists.
object
Optional source-application metadata for OneDrive for Business or SharePoint.
string
Only create the session when the target resource does not match this ETag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_CREATE_WORKBOOK_SESSIONCreate a persistent or temporary session for an Excel workbook.

Input Parameters

string
required
DriveItem ID of the Office Open XML workbook.
string
Drive containing the workbook. Use ‘me’ for the connected user’s drive, or provide a Microsoft Graph drive ID.
boolean
True to save workbook changes; false to create a temporary, non-persistent session copy.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DELETE_ITEMDelete a DriveItem (file or folder) by ID from a specified drive or user’s OneDrive, defaulting to the authenticated user’s drive. The item is moved to the recycle bin rather than permanently deleted; storage quota is not freed until the recycle bin is emptied.

Input Parameters

string
required
The unique identifier of the DriveItem (file or folder) to be deleted.
string
The user’s ID, email, or ‘me’. Defaults to ‘me’ (authenticated user). Required for S2S (app-only) auth.
string
The unique identifier of the Drive where the item is located. If not provided, the action will target the user’s personal OneDrive (me/drive). Always specify drive_id explicitly for group drives, SharePoint site drives, or shared libraries to avoid silently querying the wrong drive.
string
(Optional) If this request header is included and the eTag (or cTag) provided doesn’t match the current tag on the item, a 412 Precondition Failed response is returned, and the item won’t be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DELETE_ITEM_PERMANENTLYTool to permanently delete a driveItem by its ID without moving it to the recycle bin. Use when you need to irreversibly remove a file or folder from OneDrive or SharePoint. This action cannot be undone.

Input Parameters

string
required
The unique identifier of the drive item (file or folder) to permanently delete. This action deletes the item without moving it to the recycle bin and cannot be undone.
string
required
The unique identifier of the drive containing the item to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DELETE_ITEM_PERMISSIONTool to delete a permission from a drive item. Use when you need to revoke sharing access to a file or folder. Only non-inherited sharing permissions can be deleted.

Input Parameters

string
required
The unique identifier of the drive item (file or folder).
string
required
The unique identifier of the permission to delete. Only non-inherited sharing permissions can be deleted.
string
The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site’s drive.
string
The unique identifier of a user. Use this if the item is in a specific user’s drive (other than ‘me’).
string
The unique identifier of the drive. If not provided, the action will target the user’s personal OneDrive (me/drive).
string
The unique identifier of the group. Use this if the item is in a group’s drive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DELETE_SHARE_PERMISSIONTool to delete the permission navigation property for a shared drive item. Use when you need to remove a sharing link permission. This effectively revokes access via the specific share link.

Input Parameters

string
required
The share ID or base64-encoded sharing URL. This is the shareId returned from the createLink API response. Example format: u!aHR0cHM6Ly9jb21wb3NpbzIwMjQtbXkuc2hhcmVwb2ludC5jb20vOng6L2cvcGVyc29uYWwva2FyYW52YWlkeWFfYXV0aGtpdF9haS9JUURPT2NCVEx5RTFSWktVQkJGZ0YzZVZBUmI4Zk5XVjdhMUJidGQ1NDF2SEdXUQ

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DELETE_SHAREPOINT_ITEM_PERMISSIONRevoke a Microsoft Graph beta permission from a SharePoint list or list item.

Input Parameters

string
Optional SharePoint list item ID. Provide this to revoke a list-item permission; omit it to revoke a list-level permission.
string
required
The unique Microsoft Graph ID of the SharePoint list.
string
required
The Microsoft Graph SharePoint site ID in composite format, usually ‘hostname,site-collection-id,web-id’.
string
required
The Microsoft Graph permission ID to revoke.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DELETE_WORKBOOK_RANGEDeletes a range of cells from an Excel worksheet in OneDrive, shifting remaining cells up or left to fill the gap.

Input Parameters

string
required
The address of the range to delete in A1 notation. Can be a single cell (e.g., ‘A1’) or a range of cells (e.g., ‘A1:D4’). The range must be valid for the worksheet.
string ("Up" | "Left")
required
The direction to shift remaining cells after deletion. ‘Up’ shifts cells upward to fill the gap, ‘Left’ shifts cells leftward.
string
required
The unique identifier of the Excel workbook item. This is the driveItem ID of the .xlsx file containing the worksheet.
string
required
The unique identifier of the drive containing the workbook. Use the drive ID from list drives or get drive operations.
string
required
The name or ID of the worksheet containing the range to delete. Can be the worksheet name (e.g., ‘Sheet1’) or the worksheet ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DELETE_WORKBOOK_WORKSHEETDeletes a worksheet from a workbook in OneDrive by its ID or name. Use this action when you need to remove a specific worksheet from an Excel workbook stored in OneDrive or SharePoint. This action is irreversible — the worksheet cannot be recovered once deleted. Note that deleting the last visible worksheet in a workbook may result in an error.

Input Parameters

string
required
The ID of the workbook item (Excel file).
string
required
The ID of the drive containing the workbook.
string
Optional workbook session ID. If provided, will be sent in the ‘workbook-session-id’ header to maintain session context.
string
required
The ID or name of the worksheet to delete from the workbook. Can be either the worksheet’s unique identifier or its display name (e.g., ‘Sheet1’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DISCARD_CHECKOUTTool to discard the checkout of a driveItem, releasing it and discarding any changes made while checked out. Use when you need to cancel a checkout and revert changes on a file in SharePoint or OneDrive.

Input Parameters

string
required
The unique identifier of the drive containing the item to discard checkout.
string
required
The unique identifier of the driveItem (file or folder) to discard checkout.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DOWNLOAD_FILEDownloads a file from a user’s OneDrive using its item ID, which must refer to a file and not a folder. Response contains a content object with the downloaded file, MIME type, and name; raw file data is not returned directly. Parsing content from Excel, Word, PDF, or other formats requires additional tooling. The downloaded file can be passed to downstream tools such as OUTLOOK_SEND_EMAIL or OUTLOOK_CREATE_DRAFT.

Input Parameters

string ("pdf" | "html")
Optional format for file conversion during download. ‘pdf’ converts supported source files (doc, docx, dot, dotx, dotm, dsn, dwg, eml, epub, fluidframework, form, htm, html, loop, loot, markdown, md, msg, note, odp, ods, odt, page, pps, ppsx, ppt, pptx, pulse, rtf, task, tif, tiff, wbtx, whiteboard, xls, xlsm, xlsx) to PDF. ‘html’ converts Loop/Fluid files (loop, fluid, wbtx) to HTML. Leave empty to download the file in its original format without conversion. Do NOT use this parameter if the file is already in the target format (e.g., don’t convert PDF to PDF or HTML to HTML), as this will result in an error.
string
required
Raw item ID only (e.g., ‘1234567890ABC’). Do not include URL fragments or query parameters like ‘&cid=…’ or ‘?param=…’ from sharing links.
string
User’s ID or User Principal Name (UPN), or ‘me’ for the authenticated user’s OneDrive. Ignored when drive_id is provided.
string
The ID of the drive containing the file. Required for SharePoint or OneDrive for Business drives. When provided, user_id is ignored.
string
required
Desired filename (including extension) for the downloaded content.
string
Optional ETag or cTag value for conditional download. If the provided tag matches the current file’s tag, the API returns HTTP 304 Not Modified without downloading the file, saving bandwidth. Useful for caching scenarios.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DOWNLOAD_FILE_BY_PATHDownloads the contents of a file from OneDrive by its path. The API returns a 302 redirect to a pre-authenticated download URL. Use when you know the file path but not the item ID.

Input Parameters

string
The user’s ID, email, or ‘me’. Defaults to ‘me’ (authenticated user). Required for S2S (app-only) auth.
string
required
Desired filename (including extension) for the downloaded content.
string
required
The path to the file in OneDrive, relative to the drive root (e.g., ‘document.txt’ or ‘folder/subfolder/file.pdf’). Do not include leading slash.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DOWNLOAD_ITEM_AS_FORMATTool to download the contents of a driveItem converted to a specific format (e.g., PDF or HTML). Use when you need to convert Office documents to PDF or Loop/Fluid files to HTML before downloading. Supports accessing items by item_id or by path, and can target specific drives via drive_id.

Input Parameters

string ("pdf" | "html")
required
Format to convert the item to. Use ‘pdf’ for Office documents (doc, docx, ppt, pptx, xls, xlsx, etc.) or ‘html’ for Loop/Fluid files (loop, fluid, wbtx).
string
The unique identifier of the driveItem to convert. If provided, this takes precedence over path_and_filename.
string
User’s ID or User Principal Name (UPN), or ‘me’ for the authenticated user’s OneDrive. Ignored when drive_id is provided.
string
The unique identifier of the drive. Optional - use for SharePoint document libraries. If not provided, uses the default drive.
string
required
Desired filename (including extension) for the downloaded converted content.
string
Path and filename of the driveItem under root (e.g., ‘Documents/report.docx’ or ‘presentation.pptx’). Do not include leading slash. Either item_id or path_and_filename must be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DOWNLOAD_ITEM_THUMBNAILDownload thumbnail image bytes for a DriveItem identified by item ID.

Input Parameters

string
Thumbnail size: small, medium, large, smallSquare, mediumSquare, largeSquare, or a custom size such as c300x400 or c300x400_crop.
string
required
DriveItem ID whose thumbnail to download.
string
Drive ID containing the item. Omit to use the connected user’s drive.
string
Optional output filename. Directory components are discarded. Defaults to a generated JPEG filename.
integer
Zero-based thumbnail set index.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DOWNLOAD_ITEM_VERSIONTool to download the contents of a specific previous version of a drive item (file). Returns the actual file content. Note: You cannot download the current version using this endpoint - it only works for previous versions.

Input Parameters

string
required
The unique identifier of the drive item (file). Cannot be a folder ID.
string
The unique identifier of the drive containing the file. If not provided, defaults to the user’s personal OneDrive (me/drive).
string
required
Desired filename (including extension) for the downloaded version content.
string
required
The ID of the specific version to download (e.g., ‘1.0’, ‘2.0’). Cannot be the current version - only previous versions can be downloaded using this endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_DOWNLOAD_THUMBNAIL_BY_PATHDownload thumbnail image bytes for a path-addressed item in the current user’s OneDrive.

Input Parameters

string
Thumbnail size: small, medium, large, smallSquare, mediumSquare, largeSquare, or a custom size such as c300x400 or c300x400_crop.
string
Optional output filename. Directory components are discarded. Defaults to a generated JPEG filename.
string
required
Drive-relative path to the item. Do not include a leading slash or the /root: prefix.
integer
Zero-based thumbnail set index.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_FOLLOW_ITEMTool to follow a driveItem (file or folder) in OneDrive or SharePoint. Use when you need to add an item to the user’s followed items list for tracking updates.

Input Parameters

string
required
The unique identifier of the drive containing the item to follow. This can be the ID of a personal OneDrive, a group’s document library, or a SharePoint site’s drive.
string
required
The unique identifier of the driveItem (file or folder) to follow. DriveItem IDs are case-sensitive and must be used exactly as returned from Microsoft Graph API operations like list, search, or folder children queries.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_FORMAT_WORKBOOK_RANGEApply dimensions, alignment, wrapping, font, fill, and borders to a workbook range. Components are updated sequentially, not atomically, so earlier formatting remains if a later update fails.

Input Parameters

object
Optional fill-color change for the range.
object
Optional font changes for the range.
string
required
Range in A1 notation, such as A1:D10. Accidental wrapping quotes are removed and embedded apostrophes are escaped for OData.
array
Optional border changes, with at most one entry per side.
string
required
DriveItem ID of the Office Open XML workbook.
string
Drive containing the workbook. Use ‘me’ for the connected user’s drive, or provide a Microsoft Graph drive ID.
string
Workbook session ID returned by ONE_DRIVE_CREATE_WORKBOOK_SESSION.
object
Optional dimensions, alignment, and wrapping changes.
string
required
Worksheet ID or exact worksheet name containing the range.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_DOCUMENT_COMMENTSExtracts comments from a Word .docx file in OneDrive. The action downloads the document, parses the OOXML comments part, and returns structured comment data inline. When possible, it also includes the selected text and paragraph context from the document body so agents can understand what each comment refers to.

Input Parameters

string
required
Raw item ID of the Word .docx file. Do not include URL fragments or query parameters like ‘&cid=…’ or ‘?param=…’ from sharing links.
string
User’s ID or User Principal Name (UPN), or ‘me’ for the authenticated user’s OneDrive. Ignored when drive_id is provided.
string
The ID of the drive containing the Word document. Required for SharePoint or OneDrive for Business drives when the file is not in the authenticated user’s default drive. When provided, user_id is ignored.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_DRIVERetrieves properties and optionally expanded relationships of a Drive resource, including a specific drive or a user’s, group’s, or site’s drive.

Input Parameters

string
required
The unique identifier of the drive. This can be the ID of the user’s personal OneDrive, a group’s document library, or a specific drive ID. Must be a valid, non-empty value; use ONE_DRIVE_LIST_DRIVES to obtain valid drive IDs.
array
A comma-separated list of relationships to expand and include in the response. For example, “root,list” to include the root folder and list information. This allows you to retrieve related resources in a single request.
array
A comma-separated list of properties to include in the response. Use this to retrieve specific fields and reduce the response size. For example, “id,name,driveType”. If not provided, all default properties are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_DRIVE_ITEM_BY_SHARING_URLResolve a OneDrive or SharePoint sharing URL or share ID to drive item metadata and available IDs. An optional sharing-link redemption setting can grant durable access to the item.

Input Parameters

string
A OneDrive or SharePoint sharing URL (e.g., 1drv.ms link, SharePoint link, or Teams contentUrl). This will be automatically encoded to a sharing token. Mutually exclusive with share_id_or_encoded_url.
string ("redeemSharingLinkIfNecessary" | "redeemSharingLink")
Controls access redemption. ‘redeemSharingLink’ grants durable access to the item. ‘redeemSharingLinkIfNecessary’ grants access only for this request. If not specified, no Prefer header is sent.
array
A list of DriveItem properties to return. If not specified, a default set of properties is returned. Common fields: id, name, size, webUrl, file, folder, createdDateTime, lastModifiedDateTime, parentReference.
boolean
If true and the item is a folder, expands the children collection to include child items in the response.
string
An already-encoded sharing token (prefixed with ‘u!’) or a shareId token from a previous API call. Mutually exclusive with sharing_url.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_DRIVE_ITEM_LIST_ITEMRetrieve the SharePoint list item associated with a driveItem.

Input Parameters

string
required
ID of the driveItem whose associated SharePoint list item to retrieve.
string
required
ID of the OneDrive or SharePoint drive containing the item.
string
Set to true to include all SharePoint column values, or provide a list of internal column names to include only those values.
array
ListItem properties to return, such as id, contentType, or webUrl.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_FOLLOWED_ITEMTool to retrieve a specific followed driveItem from a drive. Use when you need to get details about a file or folder that the user has marked to follow.

Input Parameters

string
required
The unique identifier of the drive. This can be the ID of the user’s personal OneDrive, a group’s document library, or a specific drive ID.
string
required
The unique identifier of the followed driveItem to retrieve. This is the ID of a specific file or folder that has been followed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_GROUP_DRIVETool to retrieve the document library (drive) for a Microsoft 365 group. Use when you need to access the default document library associated with a specific group.

Input Parameters

string
required
The unique identifier of the group whose document library you want to retrieve.
array
A list of properties to include in the response. Use this to retrieve specific fields and reduce the response size. For example, [“id”, “name”, “driveType”]. If not provided, all default properties are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_ITEMRetrieves the metadata of a DriveItem by its unique ID. Use this tool to get information about a specific file or folder in OneDrive when you have its ID. If a drive_id is not provided, it defaults to the user’s main drive.

Input Parameters

string
required
The unique identifier of the DriveItem (file or folder). DriveItem IDs vary by platform: OneDrive for Business/SharePoint uses ‘01…’ prefix format (e.g., ‘01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK’), while OneDrive Personal uses ‘HASH!NUMBER’ format (e.g., ‘D4648F06C91D9D3D!54927’). IDs are case-sensitive and must be used exactly as returned from Microsoft Graph API. Obtain IDs from ONE_DRIVE_LIST_FOLDER_CHILDREN, ONE_DRIVE_SEARCH_ITEMS, or similar operations. Do NOT use: web URLs, sharing links, SharePoint listItem IDs, or manually constructed identifiers. IDs become stale after move, rename, or delete; refresh via ONE_DRIVE_SEARCH_ITEMS or ONE_DRIVE_LIST_FOLDER_CHILDREN instead of retrying a stale ID.
string
The unique identifier of the Drive where the item is located. If not provided, the action will target the user’s personal OneDrive (me/drive). Always specify drive_id explicitly for group drives, SharePoint site drives, or shared libraries to avoid silently querying the wrong drive.
array
A list of DriveItem properties to return. If not specified, a default set of properties is returned. Refer to the DriveItem resource documentation for available fields.
array
Navigation properties to expand in the response. Valid values: ‘children’ (folder contents), ‘thumbnails’ (image previews), ‘versions’ (version history), ‘permissions’ (sharing permissions), ‘listItem’ (SharePoint list item data), ‘activities’ (recent activities), ‘analytics’ (usage analytics), ‘createdByUser’ (creator user details), ‘lastModifiedByUser’ (last modifier user details), ‘retentionLabel’ (retention policy), ‘subscriptions’ (webhooks), ‘workbook’ (Excel workbook data). Note: ‘content’ is NOT expandable - use ONE_DRIVE_DOWNLOAD_FILE to retrieve file content; ‘listItem’ requires SharePoint drives; some properties have regional/license restrictions. When expanding ‘children’: the array may be empty or absent; check for its presence and branch on ‘file’ vs ‘folder’ facets before processing. Expansion is non-recursive — call this tool separately for each child folder to traverse nested trees.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_ITEM_BY_PATHRetrieve OneDrive or SharePoint driveItem metadata by drive-relative path.

Input Parameters

string
Drive ID containing the item. Omit to use the connected user’s drive.
string
required
Drive-relative path to a file or folder. Do not include a leading slash or the /root: prefix.
array
DriveItem properties to return. Omit to return Microsoft Graph’s default properties.
array
DriveItem relationships to expand, such as children, thumbnails, permissions, or listItem.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_ITEM_PERMISSIONSRetrieve a page of permissions for a DriveItem by ID, or by path in the current user’s drive. Use the continuation token to retrieve further pages; returned permissions can include inherited and link-based access.

Input Parameters

string
A comma-separated list of properties to include in the response. For example, ‘id,roles,link’.
string
The unique identifier of the drive item. Verify the correct item before calling — disambiguate similarly named files using folder path, timestamps, or file size. Required unless item_path is provided.
string
The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site’s drive.
string
The unique identifier of a user. Use this if the item is in a specific user’s drive (other than ‘me’).
string
The unique identifier of the drive. Required if not using other identifiers like group_id, site_id, or user_id in the path.
string
The unique identifier of a group. Use this if the item is in a group’s drive.
string
The path to the item relative to the drive’s root. Use this if item_id is not known. Must start with ’:/’ and end with ’:/’. Example: ’:/FolderA/FileB.txt:/’. Only applicable when accessing items in the current user’s drive (me/drive/root). Does NOT substitute item_id (which is required); use only as supplemental path context for items in the current user’s drive.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.
string
If this request header value (etag) matches the current etag on the item, an HTTP 304 Not Modified response is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_ITEM_THUMBNAILSTool to retrieve the thumbnails associated with a DriveItem. Use when you need to display visual previews of files. Response contains a value array with size keys (small, medium, large); thumbnails may not be generated for all file types or newly uploaded items, so handle an empty or missing value array. Returned thumbnail URLs are external HTTP endpoints with independent availability.

Input Parameters

string
A comma-separated list of thumbnail sizes to retrieve (e.g., “small,medium,large”, or “c300x400_crop”). If not specified, all available thumbnails for the first thumbnailSet (id: “0”) are returned.
string
required
The unique identifier of the DriveItem.
string
The unique identifier of a Site. Provide either drive_id, group_id, site_id, or user_id.
string
The unique identifier of a User. Provide either drive_id, group_id, site_id, or user_id.
string
The unique identifier of the Drive. If not provided, ‘me’ will be used for the current user’s drive.
string
The unique identifier of a Group. Provide either drive_id, group_id, site_id, or user_id.
boolean
If true, retrieves the thumbnail with its original EXIF orientation. This is only supported on OneDrive Personal. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_ITEM_VERSIONSTool to retrieve the version history of a DriveItem by its unique ID. Use when you need to access or list previous versions of a file. Version history may be unavailable or empty for folders or items in drives without versioning enabled.

Input Parameters

string
required
The unique identifier of the item (file or folder).
string
The unique identifier of the site. Mutually exclusive with drive_id, group_id, and user_id.
string
The unique identifier of the user. Mutually exclusive with drive_id, group_id, and site_id.
string
The unique identifier of the drive. Mutually exclusive with group_id, site_id, and user_id. One of these must be provided if not using the /me path.
string
The unique identifier of the group. Mutually exclusive with drive_id, site_id, and user_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_RECENT_ITEMSGet recently accessed files and folders using the deprecated Microsoft Graph recent endpoint. Results reflect recent activity rather than modification time; the action returns a page of items and may include a next link.

Input Parameters

integer
Maximum number of recent items to return (1-200). Controls response size for better performance. Use pagination with @odata.nextLink for larger datasets.
string
Comma-separated list of properties to include in the response. Significantly reduces payload size by returning only specified fields. Common properties: id, name, webUrl, size, lastModifiedDateTime, lastAccessedDateTime, file, folder, parentReference. If not specified, all properties are returned (large payload). Always include id in select and use returned id values directly — never reconstruct or hardcode IDs, as stale or manually constructed IDs will fail in tools like ONE_DRIVE_GET_ITEM.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_ROOTRetrieve metadata for the root folder of the signed-in user’s OneDrive or a specified user’s OneDrive, such as size, child count, or web URL.

Input Parameters

string
The user’s ID, email, or ‘me’. Defaults to ‘me’ (authenticated user). Required for S2S (app-only) auth.
array
A list of properties to include in the response. Use this to retrieve specific fields and reduce the response size. Common fields include: id, name, size, createdDateTime, lastModifiedDateTime, webUrl, folder, root. If not provided, all default properties are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_SHARETool to access a shared DriveItem or collection of shared items using a shareId or encoded sharing URL. Returns the sharedDriveItem resource with metadata about the shared item and its owner. Use when you have a shareId or sharing token and need information about what was shared.

Input Parameters

string ("redeemSharingLinkIfNecessary" | "redeemSharingLink")
Controls access redemption. ‘redeemSharingLink’ grants durable access to the item (permanent permission). ‘redeemSharingLinkIfNecessary’ grants access only for this request (temporary, no lasting permission). If not specified, no Prefer header is sent and no redemption occurs.
boolean
If true and the shared item is a folder, expands the children collection to include child items in the response. Only applicable for folders.
string
required
A sharing token (shareId) as returned by the API or a properly encoded sharing URL. To encode a URL: base64 encode it, convert to unpadded base64url format (remove ’=’ padding, replace ’/’ with ’_’, ’+’ with ’-’), and prepend ‘u!’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_SHARED_ITEMSDEPRECATED: Use ONE_DRIVE_SEARCH_DRIVE_ITEMS to find a specific shared file or ONE_DRIVE_LIST_ONEDRIVE_SHARED_ITEMS to list files shared from other people’s OneDrive accounts. Microsoft Graph sharedWithMe is degraded until November 2026 and will stop returning data after that.

Input Parameters

boolean
Set to true to include items shared from external tenants. Defaults to false, which only returns items shared within the user’s own tenant.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMSTool to get the items (list items) within a specific SharePoint list on a site. Use when you need to retrieve data from a SharePoint list.

Input Parameters

integer
The maximum number of items to return in a single response. Used for pagination.
integer
The number of items to skip in the result set. Used for pagination.
boolean
If true, returns the total count of items in the @odata.count property.
string
A comma-separated list of relationships to expand, or ‘fields($select=columnName1,columnName2)’ to retrieve specific fields. For example, to get specific columns ‘Name’ and ‘Color’, use ‘fields($select=Name,Color)’. SharePoint internal field names may differ from display names; call without expand first (or use ‘fields’ alone) to discover actual internal names before filtering or selecting specific fields.
string
An OData filter query to restrict the results. For example, to filter items where ‘Quantity’ is less than 600, use ‘fields/Quantity lt 600’.
string
A comma-separated list of properties to include in the response. Often used in conjunction with ‘$expand=fields(select=…)’. For example, ‘id,name,fields’.
string
required
The unique identifier of the list within the SharePoint site.
string
OData order by expression to sort results. For example, ‘fields/Name asc’ or ‘fields/Quantity desc’.
string
required
The unique identifier of the SharePoint site.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_SITERetrieves metadata for a specific SharePoint site by its ID. Use this action when you need to get details like display name, web URL, and creation/modification dates for a known SharePoint site.

Input Parameters

string
Comma-separated list of relationships to expand in the response. Example: columns,lists,drives
string
Comma-separated list of properties to include in the response. Example: id,displayName,webUrl
string
required
The unique identifier of the SharePoint site. This is the id property of the site resource.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_SITE_PAGE_CONTENTGets the content of a modern SharePoint site page. Use when you need to retrieve the details and content of a specific page within a SharePoint site.

Input Parameters

string
Expands related entities. For example, use ‘canvasLayout’ to include the page’s layout and web part content.
string
Comma-separated list of properties to include in the response. Example: id,name,title
string
required
The unique identifier of the site page.
string
required
The unique identifier of the SharePoint site.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_SPECIAL_FOLDERTool to retrieve a special folder in OneDrive by name. Use when you need to access well-known folders (documents, photos, approot, etc.) without looking up by path or ID.

Input Parameters

string
The user’s ID, email, or ‘me’. Defaults to ‘me’ (authenticated user). Required for S2S (app-only) auth.
array
A list of properties to include in the response. Use this to retrieve specific fields and reduce the response size. For example, [‘id’, ‘name’, ‘size’]. If not provided, all default properties are returned.
array
Navigation properties to expand in the response. Common values: ‘children’ (folder contents), ‘thumbnails’ (image previews). Other options: ‘permissions’, ‘versions’, ‘activities’, ‘analytics’, ‘createdByUser’, ‘lastModifiedByUser’, ‘retentionLabel’, ‘subscriptions’, ‘workbook’.
string ("documents" | "photos" | "cameraroll" | "approot" | "music" | "recordings")
required
The name of the special folder to retrieve. Valid values: ‘documents’ (Documents folder), ‘photos’ (Photos folder), ‘cameraroll’ (Camera Roll Backup folder), ‘approot’ (application’s personal folder), ‘music’ (Music folder), ‘recordings’ (Recordings folder - only available in OneDrive for Business/SharePoint). Special folders provide simple aliases to access well-known folders without needing the folder path or ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_USERRetrieves profile properties for a Microsoft user by user ID or user principal name, including available contact details, job information, and account status.

Input Parameters

array
Specific properties to return in the response. Use this to retrieve only the fields you need and reduce response size. Example properties: displayName, mail, jobTitle, givenName, surname, mobilePhone. If not provided, all default user properties are returned.
string
required
The user principal name (UPN) or user ID to retrieve. Examples: ‘user@contoso.com’ or ‘87d349ed-44d7-43e1-9a83-5f2406dee5bd’. This is a required parameter that identifies which user’s profile to fetch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_WORKBOOK_RANGE_FILLRead the fill color applied to an Excel worksheet range.

Input Parameters

string
required
Range in A1 notation, such as A1:D10. Accidental wrapping quotes are removed and embedded apostrophes are escaped for OData.
string
required
DriveItem ID of the Office Open XML workbook.
string
Drive containing the workbook. Use ‘me’ for the connected user’s drive, or provide a Microsoft Graph drive ID.
string
Workbook session ID returned by ONE_DRIVE_CREATE_WORKBOOK_SESSION.
string
required
Worksheet ID or exact worksheet name containing the range.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_WORKBOOK_USED_RANGERetrieves the used range of a worksheet in an Excel workbook stored in OneDrive or SharePoint without requiring the caller to know an explicit A1 range address. Use this action to read the active data region of a worksheet, optionally ignoring formatting-only cells.

Input Parameters

string
required
The DriveItem ID of the Excel workbook whose worksheet used range should be returned.
string
required
The unique identifier of the drive containing the workbook. Use ‘me’ for the authenticated user’s default OneDrive, or provide a OneDrive/SharePoint drive ID.
string
Optional workbook session ID to send in the workbook-session-id header.
boolean
Optional. When true, only cells with values are considered used cells, ignoring formatting-only cells. When omitted, Microsoft Graph uses its default behavior.
string
required
The ID or name of the worksheet whose used range should be returned. Names with spaces or special characters are URL-encoded automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GET_WORKBOOK_WORKSHEETRetrieves a specific worksheet from an Excel workbook stored in OneDrive or SharePoint using Microsoft Graph API. Use this action when you need to get details about a particular worksheet, including its ID, name, position, and visibility. The worksheet can be identified by either its unique ID or its display name.

Input Parameters

string
Comma-separated list of properties to select (e.g., ‘id,name,position’). Limits the response to only the specified fields.
string
required
The ID of the workbook item (Excel file).
string
required
The ID of the drive containing the workbook.
string
Optional workbook session ID. Use this to read from an existing Excel workbook session.
string
required
The ID or name of the worksheet to retrieve. Can be the worksheet ID or the display name. Will be URL-encoded automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GRANT_SHARE_PERMISSIONTool to grant users access to a link represented by a permission using an encoded sharing URL. Use when you need to give specific users access to a shared OneDrive or SharePoint resource.

Input Parameters

array
required
Array of Microsoft Graph role strings specifying the access level to grant. Documented/common values include ‘read’ and ‘write’; permission resources may also use ‘owner’ for SharePoint/OneDrive for Business where supported, and tenant/resource-specific roles may also be accepted by Graph.
array
required
Array of recipient objects with email addresses who will receive access to the shared link.
string
required
Base64url encoded sharing URL (must be prefixed with u!). Encode the sharing URL using base64url format and prefix with ‘u!’ to create the encoded sharing URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_GRANT_SHAREPOINT_ITEM_PERMISSIONGrant an application permission on a SharePoint list or list item using Microsoft Graph beta.

Input Parameters

array
required
Roles to grant to the application, such as read or write.
string
Optional SharePoint list item ID. Provide this to grant permission on a list item; omit it to grant permission on the list.
string
required
The unique Microsoft Graph ID of the SharePoint list.
string
required
The Microsoft Graph SharePoint site ID in composite format, usually ‘hostname,site-collection-id,web-id’.
object
required
Application identity to grant access to. Microsoft Graph beta does not create user permissions on list or list-item resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_INSPECT_WORKBOOK_TABLERead a workbook table’s occupied range and one page of its columns.

Input Parameters

string
required
DriveItem ID of the Office Open XML workbook.
string
Drive containing the workbook. Use ‘me’ for the connected user’s drive, or provide a Microsoft Graph drive ID.
string
Opaque token for the next columns page. Omit initially, then pass next_page_token back unchanged.
string
Optional workbook session ID to use for both table reads.
integer
Maximum columns to request on the first page. Microsoft Graph may return fewer.
string
required
Exact table ID or table name in the workbook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_INVITE_USER_TO_ITEMInvite users or grant permissions to a OneDrive file or folder with specified access roles. At least one of sending an invitation or requiring sign-in must be enabled.

Input Parameters

array
required
Specifies the roles to be granted to the recipients. Microsoft Graph accepts a string array; documented/common values include ‘read’ and ‘write’; permission resources may also use ‘owner’ for SharePoint/OneDrive for Business, and Graph may accept tenant/resource-specific role strings.
string
required
The unique identifier of the drive item (file or folder).
string
A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters.
string
The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site’s drive.
string
The unique identifier of a user. Use this if the item is in another user’s drive that you have access to.
string
The unique identifier of the drive. If not provided, the authenticated user’s personal drive (me/drive) will be used.
string
The unique identifier of a Microsoft 365 group. Use this if the item is in a group’s drive.
string
The password set on the invite by the creator. Optional and OneDrive Personal only.
array
required
A collection of recipients who will receive access and the sharing invitation.
boolean
Specifies whether the recipient of the invitation is required to sign-in to view the shared item. At least one of require_sign_in or send_invitation must be true.
boolean
If true, a sharing link is sent to the recipient. Otherwise, a permission is granted directly without sending a notification.
string
Specifies the dateTime after which the permission expires. ISO 8601 format. Example: “2023-12-31T23:59:59.000Z”
boolean
Optional. If true (default), any existing inherited permissions are retained on the shared item when sharing this item for the first time. If false, all existing permissions are removed when sharing for the first time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_ACTIVITIESTool to retrieve recent activities on the authenticated user’s OneDrive. Use when you need to track recent changes or actions performed across the drive.

Input Parameters

integer
The maximum number of activities to return. Must be between 1 and 999.
string
The ID of the drive to list activities for. If not provided, the default drive of the authenticated user (/me/drive) will be used.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_ALL_DRIVE_ITEMSLists a complete OneDrive or SharePoint drive safely, one Microsoft Graph delta page per invocation. Start without page_token, then pass each next_page_token back until sync_complete is true. The terminal delta_token can be saved and passed back later to fetch changes since the completed snapshot. Delta enumeration is stable under concurrent writes and avoids the request burst caused by recursively fetching every folder in one execution.

Input Parameters

integer
Maximum number of drive items to request in this page. Microsoft Graph can return fewer items and determines the final page size.
string
Related entities to expand (e.g., ‘children’, ‘thumbnails’). Use this to include related resources inline.
array
Specific properties to return for each item (e.g., [‘id’, ‘name’, ‘size’]). If omitted, default properties are returned.
string
required
The ID of the drive to list items from. This is the unique identifier for the OneDrive or SharePoint document library.
string
Opaque continuation token returned as next_page_token or delta_token by a previous call. Omit it to start a complete drive enumeration.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_BUNDLESTool to retrieve a list of bundle resources from a specified drive. Bundles are collections of files (e.g., photo albums). Use when you need to list bundles in a drive.

Input Parameters

integer
The maximum number of items to return in a single page. Must be between 1 and 999.
string
Comma-separated list of relationships to expand (e.g., ‘children’). Note: expand=children is not supported for listing bundles.
string
OData filter query to filter bundles. For example, ‘bundle/album ne null’ to list only photo albums.
string
Comma-separated list of properties to include in the response (e.g., ‘id,name,bundle’).
string
A comma-separated list of properties to order the results by, optionally followed by ‘asc’ or ‘desc’ (e.g., ‘name desc’).
string
required
The unique identifier of the drive to list bundles from.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_DRIVESTool to retrieve a list of Drive resources available to the authenticated user, or for a specific user, group, or site. Use when you need to find out what drives are accessible. Returns only drives within the signed-in account’s permission scope; missing drives indicate insufficient permissions or different tenant scope. Results are paginated — pass the returned next_page_token back as page_token across all pages to avoid missing drives. Returned drives represent document libraries and may not reflect full SharePoint site structure; use SHARE_POINT_GET_SITE_COLLECTION_INFO or SHARE_POINT_SEARCH_QUERY for broader coverage. Use driveType and webUrl to distinguish personal, system, and SharePoint-backed drives.

Input Parameters

integer
The maximum number of items to return in a single page. Must be between 1 and 999.
string
Comma-separated list of relationships to expand (e.g., “root,list”).
string
Comma-separated list of properties to include in the response (e.g., “id,name,driveType”).
string
A comma-separated list of properties to order the results by, optionally followed by “asc” or “desc” (e.g., “name desc”).
string
The ID of the site to list drives for. If provided, group_id and user_id should not be used.
string
The ID of the user to list drives for. If provided, group_id and site_id should not be used. If none of group_id, site_id, or user_id are provided, the drives for the current authenticated user (/me/drives) will be listed.
string
The ID of the group to list drives for. If provided, site_id and user_id should not be used.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_FOLDER_CHILDRENList the direct children (files/folders) of a OneDrive/SharePoint folder by DriveItem ID or path. Returns reliable pagination tokens for large folders. Use when you need to enumerate folder contents deterministically, find companion artifacts (e.g., .vtt/.docx files), or browse within a known folder.

Input Parameters

integer
Maximum number of items to return per page. Default is 200.
array
List of relationships to expand in the response (e.g., [‘thumbnails’, ‘permissions’]). Use this to include related resources inline.
array
Comma-separated list of properties to include in the response (e.g., [‘id’, ‘name’, ‘size’]).
string
Sort results by specified properties (e.g., ‘name’, ‘lastModifiedDateTime desc’).
string
If provided, uses /sites/{site-id}/drive/… route for SharePoint sites.
string
The ID of the drive. Required unless using ‘use_me_drive’ or ‘site_id’ is provided.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.
string
Path relative to the drive root (e.g., ’/’, ‘/Recordings’, ‘/Documents/Project’). Use ’/’ to list the root folder’s children. Alternative to ‘folder_item_id’.
boolean
If true, uses /me/drive/… route for the authenticated user’s personal OneDrive.
string
The ID of the folder (DriveItem) to list children from. Supports both simple item IDs (e.g., ‘01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K’) and drive-qualified item IDs with ’!’ separator (e.g., ‘driveId!itemId’ format commonly returned from search results or shared item listings). When a drive-qualified ID is detected, the drive portion is automatically extracted and used in the API request. Note: The ‘driveId!itemId’ pattern is based on observed OneDrive API behavior and may not be explicitly documented. Required unless ‘folder_path’ is provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_FOLLOWED_SITESList SharePoint sites followed by the signed-in organizational user. Microsoft documents a known issue that can make results incorrect.

Input Parameters

string
Opaque continuation token from the preceding response. Omit for the first page and pass next_page_token back unchanged for later pages.
array
Site properties to return. Allowed values are id, name, displayName, description, createdDateTime, lastModifiedDateTime, webUrl, eTag, isPersonalSite, root, sharepointIds, and siteCollection.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_ITEM_ACTIVITIESTool to list recent activities for a specific item in a OneDrive drive. Use when you need to track changes or actions performed on a file or folder.

Input Parameters

string
required
The unique identifier of the driveItem.
string
required
The unique identifier of the drive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_ONEDRIVE_SHARED_ITEMSList files shared from other people’s OneDrive accounts using Microsoft Graph Search match-all and a OneDrive-personal URL heuristic. This excludes SharePoint-site shares by design; use ONE_DRIVE_SEARCH_DRIVE_ITEMS for broad keyword/KQL search across OneDrive and SharePoint.

Input Parameters

integer
Zero-based result offset for paging through the match-all search.
integer
Number of search results to inspect before filtering.
array
Optional driveItem fields to return on each hit resource. webUrl and parentReference are always included because they are required to identify shared OneDrive-personal items.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_ROOT_DRIVE_CHANGESList drive item changes using Microsoft Graph delta, including additions, modifications and deletions, for a specified drive or the current user’s drive. Initial enumeration can span multiple pages; follow next links until a delta link is returned, then use it for subsequent changes.

Input Parameters

integer
Maximum number of items to return in a single response. Useful for pagination and controlling response size.
string
Either a raw token string or a full URL from @odata.nextLink/@odata.deltaLink. Accepts: raw token value, full pagination URL, or ‘latest’ to get a token for future calls. Omit to get all current items. Loop until @odata.nextLink is absent to get complete results; default page size is ~200 items.
string
Comma-separated list of relationships to expand in the response.
string
Comma-separated list of DriveItem properties to include in the response. Use this to retrieve specific fields and reduce response size.
string
The ID of the drive to track changes for. If not provided, will attempt to use the authenticated user’s default drive (requires delegated auth). For application auth, this parameter is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SHARE_PERMISSIONSTool to retrieve permission details for a shared OneDrive or SharePoint item using a share ID. Use when you have an encoded sharing URL and need to check the permission level, password protection, and access details.

Input Parameters

string
required
The share ID (encoded sharing URL in format u!<base64url> or share token) to retrieve permission for. This is typically an encoded sharing URL prefixed with ‘u!’ or a shareId token from a previous API call.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SHAREPOINT_ITEM_PERMISSIONSList Microsoft Graph beta permissions from a SharePoint list or list item.

Input Parameters

integer
Optional OData $top page size.
string
Optional OData $select value, for example id,roles,grantedToV2,grantedToIdentitiesV2.
string
Optional SharePoint list item ID. Provide this to list permissions for a list item; omit it to list permissions for the list.
string
required
The unique Microsoft Graph ID of the SharePoint list.
string
required
The Microsoft Graph SharePoint site ID in composite format, usually ‘hostname,site-collection-id,web-id’.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTATool to track changes to items in a SharePoint list using a delta query. Use when you need to get newly created, updated, or deleted list items without performing a full read of the entire item collection.

Input Parameters

integer
Maximum number of items to return in a single response.
string
If unspecified or empty, enumerates the current state. If ‘latest’, returns an empty response with the latest delta token. If a previous delta token, returns changes since that token.
string
Comma-separated list of relationships to expand. Use ‘fields($select=ColumnA,ColumnB)’ format for field selection.
string
Comma-separated list of listItem properties to return.
string
required
The unique identifier of the list within the site.
string
required
SharePoint site ID in composite format: hostname,site-collection-guid,site-guid (three comma-separated parts).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SITE_COLUMNSTool to list all column definitions for a SharePoint site. Use this when you need to retrieve the schema or structure of columns within a specific SharePoint site.

Input Parameters

integer
The maximum number of items to return.
boolean
If true, returns the total count of items in the @odata.count property.
string
Comma-separated list of related resources to expand in the response.
string
OData filter expression to apply to the results.
string
Comma-separated list of properties to include in the response.
string
Comma-separated list of properties used to sort the results.
string
required
The unique identifier of the SharePoint site. Example: contoso.sharepoint.com,2C712604-133D-4A7C-9194-F53CE4C952A2,A704AEF5-C2C0-43C3-A3D8-9F55A73A02E2

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SITE_ITEMS_DELTATool to track changes to DriveItems in the default document library of a SharePoint site. Use when you need to get a list of items that have been added, modified, or deleted since a previous state or to get an initial enumeration of all items.

Input Parameters

integer
Maximum number of items to return in a single response. Useful for pagination and controlling response size.
string
A token used to retrieve a specific page of results or to get changes since a previous state. Can be ‘latest’ to get the most recent delta token without items, a deltaLink URL, or a timestamp (YYYY-MM-DDTHH:MM:SSZ).
string
Comma-separated list of relationships to expand in the response.
string
Comma-separated list of DriveItem properties to include in the response. Use this to retrieve specific fields and reduce response size.
string
required
The unique identifier of the SharePoint site.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SITE_LISTSTool to list all lists under a specific SharePoint site. Use when you need to enumerate lists within a known site. Returns only Microsoft Graph-supported lists — internal/system lists are excluded, so results may be a strict subset of all site lists (e.g., 13 returned where 108 exist). Results are in the data.value array. IMPORTANT: Only works with organizational Microsoft 365 accounts (Azure AD/Entra ID). NOT supported for personal Microsoft accounts (MSA/Outlook.com/Hotmail). Personal OneDrive users cannot access SharePoint sites through this endpoint.

Input Parameters

integer
The maximum number of items to return.
string
Comma-separated list of relationships to expand in the response. Example: columns,items
string
OData filter expression. Example: startswith(name,‘Doc’)
string
Comma-separated list of properties to include in the response. Example: id,name,list
string
OData order by expression. Example: name asc
string
required
SharePoint site ID in the required composite format: ‘hostname,site-collection-id,web-id’ (e.g., ‘contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D4B0860-D7DE-419B-88E6-5866AF240000’). Must contain exactly two commas separating three parts: (1) SharePoint hostname, (2) site collection GUID, (3) web GUID. Only works with organizational Microsoft 365 accounts.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SITE_RECYCLE_BIN_ITEMSReturn one page of deleted items from a SharePoint site’s recycle bin. This action uses Microsoft Graph’s beta API, which can change without notice and isn’t supported for production applications.

Input Parameters

integer
Maximum number of recycle-bin items requested for the first page.
string
required
SharePoint site ID whose recycle bin should be listed.
string
Opaque next-page token returned by this action. Pass it back unchanged to continue the same site’s recycle-bin feed.
array
Recycle-bin item properties to return, such as id, name, size, and deletedDateTime.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SITE_SUBSITESLists subsites of a SharePoint site for an organizational Microsoft 365 account. Results are paginated and can be filtered; an empty page does not necessarily mean the site has no subsites.

Input Parameters

integer
The maximum number of items to return.
string
Comma-separated list of relationships to expand in the response.
string
OData filter expression. Example: startswith(name,‘Project’)
string
Comma-separated list of properties to include in the response. Example: id,name,webUrl
string
OData order by expression. Example: name asc, createdDateTime desc
string
required
The unique identifier of the SharePoint site for which to list subsites. Must be the full composite Graph ID in the format hostname,siteCollectionId,siteId; partial or malformed IDs may silently return empty results rather than an error.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_SUBSCRIPTIONSLists current webhook subscriptions for the authenticated user or app, one page at a time. Results may span multiple drives and resources and can be filtered client-side by resource URL or type.

Input Parameters

string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_WORKBOOK_NAMESList defined names and formulas in an Excel workbook. Microsoft documents this endpoint for delegated work or school and personal Microsoft accounts. Application permissions are not supported.

Input Parameters

string
required
DriveItem ID of the Excel workbook.
string
required
Drive containing the workbook. Use me for the connected user’s drive, or pass a Drive resource ID.
string
Opaque continuation token returned as next_page_token by a previous call. Pass it back unchanged with the same drive_id and item_id.
string
Optional workbook session ID used to read names from an existing Excel workbook session.
array
Named-item properties to return. Allowed values are comment, name, scope, type, value, and visible. Formula text is returned through value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_LIST_WORKBOOK_WORKSHEETSRetrieves a list of all worksheets in an Excel workbook stored in OneDrive or SharePoint. Returns worksheet metadata including IDs, names, positions, and visibility states. Use this action when you need to enumerate available worksheets in a workbook, find a specific worksheet by name, or understand the workbook structure before performing operations on worksheet data.

Input Parameters

integer
Not applied. The Excel workbook worksheets endpoint returns all worksheets in a single response and does not support $top-based paging with a continuation cursor, so this value is deliberately not sent (a small $top would silently drop worksheets). Kept for backward compatibility.
integer
Number of worksheets to skip before returning results (manual offset). This endpoint returns all worksheets in one response, so pagination is not needed; use only for an explicit offset.
string
Comma-separated list of specific fields to return for each worksheet (e.g., ‘id,name,position’). If not specified, default fields (id, name, position, visibility) are returned. Refer to the workbookWorksheet resource documentation for available fields.
string
required
The unique identifier of the workbook item (Excel file). This must be the DriveItem ID of an Excel workbook file (.xlsx, .xlsm, etc.). IDs are case-sensitive and must be used exactly as returned from Microsoft Graph API. Obtain IDs from ONE_DRIVE_LIST_FOLDER_CHILDREN, ONE_DRIVE_SEARCH_ITEMS, or similar operations.
string
required
The unique identifier of the OneDrive or SharePoint drive containing the workbook. Use a Drive resource ID such as a OneDrive Personal drive ID or a SharePoint/OneDrive for Business drive ID (commonly prefixed with ‘b!’). Obtain this from ONE_DRIVE_LIST_DRIVES, ONE_DRIVE_GET_DRIVE, or similar drive-level operations. Do not pass a DriveItem/file ID here.
string
Optional workbook session ID. Use this to list worksheets from an existing Excel workbook session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_MOVE_ITEMTool to move a file or folder to a new parent folder in OneDrive. Use when you need to reorganize your files or folders by changing their location. You can optionally rename the item during the move. If a file with the same name exists at the destination, the API returns nameAlreadyExists; use the name parameter to provide a unique name or resolve the conflict beforehand.

Input Parameters

string
The new name for the DriveItem. If not provided, the item retains its original name. Must not contain illegal filename characters; invalid characters cause an invalidRequest error.
string
required
The unique identifier of the file or folder (DriveItem) to be moved.
string
The unique identifier of the site if the item is in a SharePoint site. Mutually exclusive with drive_id, group_id, and user_id.
string
The unique identifier of the user if accessing another user’s drive. Mutually exclusive with drive_id, group_id, and site_id.
string
The unique identifier of the Drive that contains the item. If not specified, it defaults to the user’s personal drive (/me/drive).
string
The unique identifier of the group if the item is in a group drive. Mutually exclusive with drive_id, site_id, and user_id.
string
The new description for the drive item. If not provided, the item’s description is not changed.
object
required
An object specifying the destination folder. Must be provided as an object/dictionary with an ‘id’ field containing the folder’s unique identifier. Format: {“id”: “<folder-id>”, “driveId”: “<drive-id>”} (driveId is optional). Example: {“id”: “01BYE5RZZ272Y2AM3L22L22Z2Y2Y2Y2Y2Y”}. Note: Folder names are not accepted - use the folder’s unique ID obtained from listing or searching items.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_ONEDRIVE_CREATE_FOLDERCreates a new folder in the user’s OneDrive with configurable conflict behavior, optionally within a specified parent_folder (by ID or full path from root) which, if not the root, must exist and be accessible.

Input Parameters

string
required
The desired name for the new folder (also accepts ‘folder_name’ as an alias). If a folder with this name already exists in the specified parent_folder, the new folder will be automatically renamed (e.g., ‘New Folder’ might become ‘New Folder 1’). Examples: [‘Annual Reports’, ‘Client Meeting Notes’]
string
The user’s ID, email, or ‘me’. Defaults to ‘me’ (authenticated user). Required for S2S (app-only) auth.
string
Optional description for the folder. Provides a user-visible description of the folder. Examples: [‘Project documents for Q1 2024’, ‘Meeting notes archive’]
string
ID or full path of the parent folder for the new folder. Paths must start from the root (e.g., ‘/Documents/Reports’). If an ID is provided, it refers to an existing folder’s unique ID. Examples: [‘/Projects/Alpha’, ‘folder_id_12345ABC’, ’/’]
string ("fail" | "rename" | "replace")
How Microsoft Graph should handle a folder name conflict in the target parent folder. Use ‘fail’ to return an error, ‘rename’ to create a uniquely renamed folder, or ‘replace’ to replace the existing item when supported by Graph.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_ONEDRIVE_CREATE_TEXT_FILECreates a plain-text file in a user’s OneDrive folder, identified by ID or path. The conflict behavior can fail, replace, or rename; content is plain text regardless of filename extension.

Input Parameters

string
required
The desired name for the new text file, including its extension (e.g., ‘report.txt’, ‘notes.log’). Also accepts ‘file_name’ as an alias.
string
The folder within the user’s personal OneDrive where the new text file will be created. Use ’/’ for root, a path like ‘/Documents/Projects’ (relative to OneDrive root), a folder name like ‘MyFolder’ (treated as ‘/MyFolder’), or a valid folder ID. Note: Paths are resolved against the user’s personal OneDrive (/me/drive/root) only and cannot target SharePoint document libraries or shared drives.
string
required
The plain text content to be written into the new file. For very large text bodies, the request may fail or truncate; split large content across multiple files if needed.
string
The user’s ID or the literal ‘me’ to represent the currently authenticated user.
string ("fail" | "replace" | "rename")
How to handle conflicts when a file with the same name already exists. ‘fail’ (default) returns an error if the file exists, ‘replace’ overwrites the existing file, ‘rename’ creates a new file with an incremented name (e.g., ‘file 1.txt’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_ONEDRIVE_FIND_FILEFind files or folders by exact name within a specified OneDrive folder, without searching subfolders. Results may be paginated; iterate all pages to avoid missing matches.

Input Parameters

string
required
The exact name of the file or folder to find within the specified folder. Multiple items may match common names; use response_detail='full' and disambiguate by path, size, or last-modified timestamp.
integer
Maximum number of matching items to return in this page.
string
Opaque Microsoft Graph skip token from a previous page.
string
The unique identifier (ID) or absolute path of the OneDrive folder for the search. For the root folder, use ’/’. Paths must start with ’/’. A non-existent folder silently returns no results rather than an error.
string
The unique identifier of the user (e.g., a GUID) or the alias ‘me’ to represent the currently authenticated user. This determines whose OneDrive will be accessed.
string ("minimal" | "full")
Level of detail in the response. ‘minimal’ (default) returns only essential properties (id, name, webUrl). ‘full’ returns complete metadata for each found item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_ONEDRIVE_FIND_FOLDERFind direct child folders in a OneDrive parent folder, optionally matching an exact name. Results are returned one page at a time; a page can be empty even when later pages contain matches.

Input Parameters

integer
Maximum number of items to return in a single page. Use the returned next_page_token to fetch subsequent pages.
string
Exact name of the folder to find. If omitted, all direct child folders of the parent folder are returned.
string
Comma-separated list of relationships to expand in the response (e.g., ‘thumbnails’, ‘children’). See Microsoft Graph API documentation for supported expand properties.
string
Path (e.g., ‘/My Files/Work’, ’/’ for root) or unique ID of the parent folder where child folders are searched.
array
List of properties to include in the response (e.g., [‘id’, ‘name’, ‘size’]). Supports standard driveItem properties like id, name, webUrl, size, createdDateTime, lastModifiedDateTime, folder, etc. Note: ‘folder’ field is automatically included to enable folder identification, and ‘name’ is auto-included when filtering by folder name.
string
Sort results by specified properties (e.g., ‘name’, ‘lastModifiedDateTime desc’).
string
User’s unique identifier (e.g., email, UPN) or ‘me’ for the authenticated user, specifying the OneDrive account.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_ONEDRIVE_LIST_ITEMSLists one page of files and folders at the root of a user’s OneDrive without recursively listing subfolders. Pass the returned next-page token back to retrieve further pages; results may include remote-item pointers to shared items in other drives.

Input Parameters

integer
Maximum number of items to return in this page. The Microsoft Graph API may cap this (e.g., to 999). Fetch further pages with the returned next_page_token.
array
Specifies driveItem properties to return. If omitted or empty, default properties are returned. Refer to Microsoft Graph API documentation for a complete list of driveItem properties.
string
User’s unique identifier (e.g., ‘user@example.com’, object ID) or ‘me’ for the authenticated user’s OneDrive.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers (e.g. user_id), but select/top need not be repeated — the token carries them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_ONEDRIVE_UPLOAD_FILEUploads a file to a OneDrive or SharePoint folder using chunked uploads, creating missing destination folders as needed. Name conflicts can be renamed, rejected, or replaced.

Input Parameters

object
The file to be uploaded, including its name and access to its binary content. Required if source_url is not provided.
string
Destination folder path from root (e.g., ‘/Documents/Reports’) or a unique folder ID. If the folder path doesn’t exist, it will be created automatically (including any intermediate folders in the path).
string
The unique identifier of the SharePoint site to upload to. If provided, uses /sites/{siteId}/drive. Mutually exclusive with drive_id.
string
User ID (e.g., user_principal_name, unique GUID) or ‘me’ for the authenticated user, determining the target OneDrive.
string
The unique identifier of the drive to upload to. If not provided, uses the default drive of the user_id. Mutually exclusive with site_id.
string
Name for the file in OneDrive when using source_url, including extension (e.g., ‘report.pdf’, ‘image.png’). If not provided when using source_url, the filename will be extracted from the URL or Content-Disposition header. Ignored when using file parameter (filename comes from file.name).
string
Public HTTPS URL of the file to download and upload to OneDrive. Custom source headers are not supported. Required if file is not provided.
boolean
Deprecated. SSL verification is always required for source_url downloads.
string
A user-visible description of the file. Only supported on OneDrive Personal.
boolean
If true, the final file creation is deferred until an explicit completion request is made. Useful for large files where you want to control when the upload is finalized.
string
An ETag value to prevent lost updates. If provided, the upload will only proceed if the folder/parent’s ETag matches this value. Returns 412 error if it doesn’t match.
object
Deprecated. Custom HTTP headers are not supported when downloading from source_url.
object
File system information on client.
string ("rename" | "fail" | "replace")
How to handle file name conflicts. ‘rename’ automatically renames the file if it exists (default), ‘fail’ returns an error, ‘replace’ overwrites the existing file. When renamed, the actual filename in the response may differ (e.g., suffixed with a number); use the response id or webUrl for follow-up operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_PREVIEW_DRIVE_ITEMGenerates or retrieves a short-lived, permission-bound embeddable URL for a preview of a specific item. URLs expire and must be regenerated per session — do not cache. Use when you need to display a temporary preview of a file.

Input Parameters

string
Optional. Page number of document to start at, if applicable. Specified as string for future use cases around file types such as ZIP.
number
Optional. Zoom level to start at, if applicable.
string
required
The unique identifier of the DriveItem.
string
The unique identifier of the Site. Provide if the item is in a SharePoint site.
string
The unique identifier of the User. Provide if the item is in another user’s drive.
string
The unique identifier of the Drive. If not provided, the request will be made to the current user’s drive.
string
The unique identifier of the Group. Provide if the item is in a group drive.
string
The unique identifier of the shared item. Provide if the item is accessed via a share link.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_READ_WORKBOOK_RANGEReads a range of cells from an Excel workbook worksheet stored in OneDrive or SharePoint using Microsoft Graph API. Returns cell values, formulas, formatting, and metadata for the specified range. Use this action when you need to extract data from specific cells in an Excel file, whether reading a single cell, a rectangular range, an entire column, or an entire row. The range address must be specified in A1 notation (e.g., ‘A1:B5’).

Input Parameters

string
required
The range address in A1 notation. Supports single cells (e.g., ‘A1’), cell ranges (e.g., ‘A1:B5’), entire columns (e.g., ‘A:A’), or entire rows (e.g., ‘1:1’). The address is used as-is in the Graph API function call syntax.
string
required
The unique identifier of the workbook item (Excel file). This is the DriveItem ID for the Excel file containing the worksheet you want to read from.
string
required
The unique identifier of the drive containing the workbook. Required to locate the Excel file in OneDrive or SharePoint.
string
Optional workbook session ID. Use this to read from an existing Excel workbook session.
array
Optional list of specific fields to return in the response. If not specified, all default range properties are returned. Available fields include: address, addressLocal, cellCount, columnCount, columnHidden, columnIndex, hidden, rowCount, rowHidden, rowIndex, values, formulas, text, valueTypes, numberFormat.
string
required
The ID or name of the worksheet within the workbook. Can be a worksheet name like ‘Sheet1’ or a worksheet ID like ‘{00000000-0001-0000-0000-000000000000}’. Non-ASCII names are automatically URL-encoded.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_RESTORE_DRIVE_ITEMTool to restore a deleted OneDrive driveItem (file or folder) from the recycle bin. Use when you need to recover a deleted item to its original location or to a specified parent folder, optionally renaming it during restoration. IMPORTANT LIMITATION: This API is ONLY available for OneDrive Personal accounts. It does NOT work with OneDrive for Business or SharePoint. For Business/SharePoint accounts, use the SharePoint REST API endpoints (/_api/web/recyclebin) instead.

Input Parameters

string
(Optional) The new name for the restored item. If not provided, the item will be restored with its original name. This is useful if you want to rename the item during the restore process or if an item with the same name already exists in the destination.
string
required
The unique identifier of the deleted DriveItem (file or folder) to restore. This item must currently be in the OneDrive recycle bin. The ID can be obtained from deleted items listing or from the item before deletion.
string
The unique identifier of the Drive containing the deleted item. Required when using application authentication. If not provided with delegated authentication, uses the authenticated user’s default drive.
string
(Optional) The unique identifier of the parent folder where the item should be restored. If not provided, the item will be restored to its original parent location. This is useful when you want to restore the item to a different folder than where it was originally located.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_RESTORE_ITEM_VERSIONRestores a previous version of a DriveItem (file) by creating a new version with the content of the specified version. Use this action when you need to revert a file to an earlier version. The restoration is permanent and creates a new current version — the file cannot be automatically reverted after this operation, though you can restore again to a different version if needed. This action is irreversible in the sense that it immediately changes the current file content.

Input Parameters

string
required
The unique identifier of the DriveItem (file) whose version you want to restore.
string
The user’s ID, email, or ‘me’. Defaults to ‘me’ (authenticated user) if not provided. Required for S2S (app-only) auth to specify target user.
string
The unique identifier of the Drive where the item is located. If not provided, the action will target the user’s personal OneDrive (me/drive). Always specify drive_id explicitly for group drives, SharePoint site drives, or shared libraries to avoid silently querying the wrong drive.
string
required
The unique identifier of the version to restore. This creates a new version with the content of the specified previous version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_SEARCH_DRIVE_ITEMSSearch OneDrive and accessible SharePoint files with Microsoft Graph Search. This does not produce a complete shared-with-me list; use deprecated ONE_DRIVE_GET_SHARED_ITEMS only when full shared-with-me enumeration is required before Microsoft removes that API in November 2026. Requires OneDrive permissions plus Sites.Read.All because SharePoint-backed files can appear in results.

Input Parameters

integer
Zero-based result offset for paging.
integer
Number of search results to return.
string
required
Microsoft Search query for OneDrive and SharePoint driveItem results. KQL is supported. Use ’*’ to match all accessible drive items.
array
Optional driveItem fields to return on each hit resource.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_SEARCH_ITEMSSearch OneDrive files and folders by keyword, with sorting and pagination. The action transforms certain KQL-like and path queries and removes wildcards; results may include files and folders, and recently changed items may be delayed by indexing.

Input Parameters

string
required
The query text used to search for items. Values are matched across filenames, metadata, and file content. This is a simple keyword-based search only - NOT KQL (Keyword Query Language). IMPORTANT: (1) KQL operators like ‘folder:’, ‘file:’, ‘content:’, ‘filetype:’ are NOT supported by this endpoint and will be treated as literal text search. Use plain keywords instead (e.g., ‘shared documents’ not ‘folder:shared’). (2) Path-based filtering syntax (e.g., ‘path:/folder’) is NOT supported and will be transformed to a keyword search. (3) Wildcard characters (* and ?) are NOT supported and will be automatically removed - use file extension keywords instead (e.g., ‘mp4’ instead of ‘*.mp4’). To search within a specific folder, use ONE_DRIVE_LIST_FOLDER_CHILDREN.
integer
The maximum number of items to return in a single page. Default is 200.
string
A comma-separated list of relationship names to expand and include in the response. For driveItem resources, you can expand relationships like ‘children’ to get child items, ‘thumbnails’ to get thumbnail metadata, or ‘permissions’ to get sharing permissions. For example, use ‘children’ to include the child items of folders in search results, or ‘thumbnails’ to include thumbnail URLs. Note: Not all relationships may be expandable in search results. Refer to the Microsoft Graph API documentation for supported expansions.
string
Comma-separated list of driveItem properties to include in the response. Valid properties include: id, name, webUrl, size, createdDateTime, lastModifiedDateTime, file, folder, parentReference, createdBy, lastModifiedBy, fileSystemInfo, searchResult, remoteItem, etc. Note: @-prefixed annotations (e.g., @microsoft.graph.downloadUrl) are automatically stripped as they are not valid in $select queries for search endpoints.
string
A comma-separated list of properties used to sort the order of the items in the response. Use ‘asc’ or ‘desc’ for ascending or descending order, e.g., ‘name asc’.
string
The ID of the drive to search within. If not provided, the user’s personal drive (me/drive) will be searched. Use ONE_DRIVE_LIST_DRIVES to get valid drive IDs. Note: Some drive ID formats (e.g., secondary personal drives or special SharePoint IDs) may return ‘ObjectHandle is Invalid’ errors due to Microsoft Graph API limitations.
string
Opaque continuation token for the next page. Omit for the first page; then pass back the next_page_token from the previous response, unmodified, until it is absent. Do not construct or edit it. When set, it drives pagination; resend the same required identifiers, but filter/sort params need not be repeated — the token carries them.
string ("drive" | "root")
Specifies the scope of the search. ‘root’ searches within the folder hierarchy starting from root (uses /drives/{drive_id}/root/search or /me/drive/root/search). ‘drive’ broadens the search to include items shared with the current user (uses /drives/{drive_id}/search or /me/drive/search). This parameter is respected both with and without a drive_id.
array
Internal field to track stripped annotations. Not exposed to API.
string
Internal field to track if path-based query was transformed. Not exposed to API.
string
Internal field to track if a KQL operator was transformed. Not exposed to API.
string
Internal field to track if parent: filter was stripped from query. Not exposed to API.
string
Internal field to track if wildcard characters were removed from query. Not exposed to API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_SEARCH_SHAREPOINT_SITESSearch SharePoint sites visible to an organizational Microsoft account.

Input Parameters

string
Free-text keywords to match across SharePoint site properties. Required for the first page; omit when page_token is provided.
string ("createdDateTime asc" | "createdDateTime desc")
Optional creation-time ordering. This endpoint supports only createdDateTime asc or createdDateTime desc.
integer
Maximum sites to request on the first page. Must be between 1 and 999; Microsoft Graph may return fewer.
string
Opaque continuation token for the next page. Omit it initially, then pass next_page_token back unchanged. The token carries the original search, page size, and ordering.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_TRACK_FOLDER_CHANGESTrack changes beneath one folder, one Microsoft Graph delta page at a time.

Input Parameters

integer
Maximum page size to request from Microsoft Graph. Graph can return a different number of items.
string
Drive ID containing the folder. Omit to use the connected user’s drive.
string
required
ID of the folder whose hierarchy should be synchronized.
string
Opaque next-page or delta token returned by this action. Omit to start a folder synchronization.
array
DriveItem properties to return. Applied only when starting a synchronization.
array
DriveItem relationships to expand. Applied only when starting a synchronization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UNFOLLOW_ITEMTool to unfollow a driveItem by removing it from the user’s followed items collection. Use when you need to stop following a file or folder that was previously marked to follow.

Input Parameters

string
required
The unique identifier of the driveItem to unfollow. This is the ID of an item in the user’s followed items collection.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATATool to update the metadata of a specific item (file or folder) in OneDrive. Use this to rename items, change descriptions, or move items to a new parent folder.

Input Parameters

string
The new name for the drive item. Must not contain illegal characters: \, /, :, *, ?, ', <, >, &#124;; these trigger an invalidRequest error.
string
required
The unique identifier of the drive item (file or folder) to update.
string
The unique identifier of the site. Used when updating an item within a site’s drive.
string
The unique identifier of the user. Used when updating an item within a specific user’s drive.
string
The unique identifier of the drive. Required if not using other specific paths like /me, /groups/{group-id}, /sites/{site-id}, or /users/{user-id}.
string
The unique identifier of the group. Used when updating an item within a group’s drive.
string
The eTag or cTag value for conditional update. If this header is included and the eTag provided doesn’t match the current eTag on the item, a 412 Precondition Failed response is returned. Use this to prevent conflicts when multiple users update the same item.
string
The new description for the drive item.
object
File system information on client.
string
The ID of the new parent item. Use this to move the item. The driveId of the parentReference can also be specified if moving between drives. For cross-drive moves, parent_reference_drive_id is required alongside this field. Omit both fields when only renaming or updating metadata to avoid unintended moves.
string
The drive ID of the new parent item, if moving to a different drive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UPDATE_DRIVE_ITEMS_PERMISSIONSTool to update the roles of an existing permission on a OneDrive drive item. Use when you need to change the access level (read, write, owner) for a specific permission on a file or folder.

Input Parameters

array
required
Array of Microsoft Graph role strings to assign to the permission. Documented/common values include read, write, and owner for SharePoint/OneDrive for Business permission resources; tenant/resource-specific roles may also be accepted by Graph.
string
required
The unique identifier of the drive item.
string
The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site’s drive.
string
The unique identifier of a user. Use this if the item is in a specific user’s drive (other than ‘me’).
string
The unique identifier of the drive. Required if not using other identifiers like group_id, site_id, or user_id.
string
The unique identifier of a group. Use this if the item is in a group’s drive.
string
required
The unique identifier of the permission to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UPDATE_FILE_CONTENTTool to update an existing file’s content in OneDrive. When called without a file parameter, creates an upload session and returns its uploadUrl (legacy behavior — caller drives the PUT uploads). When called with a file, the action streams the file’s bytes in chunks via the upload session and returns the final updated DriveItem. The item’s ID is preserved (existing share links remain valid) unless conflict_behavior=rename causes the server to create a new item.

Input Parameters

object
Optional file content to upload. When provided, the action creates an upload session, streams the file bytes in chunks, and returns the updated DriveItem (id/name/size/file). When omitted, the action only creates the upload session and returns its uploadUrl + session metadata, leaving subsequent PUT uploads to the caller (legacy behavior).
string
required
The unique identifier of the DriveItem (file) to update.
string
The unique identifier of the SharePoint site. If provided, uses /sites/{siteId}/drive. Mutually exclusive with drive_id, group_id, and user_id.
string
The unique identifier of the user. If provided, uses /users/{userId}/drive. Mutually exclusive with drive_id, site_id, and group_id.
string
The unique identifier of the drive. If not provided, uses /me/drive. Mutually exclusive with site_id, group_id, and user_id.
string
The unique identifier of the group. If provided, uses /groups/{groupId}/drive. Mutually exclusive with drive_id, site_id, and user_id.
boolean
If true, the final file creation is deferred until an explicit completion request is made. Useful for very large files when the caller drives the upload themselves. Ignored when file is provided — the chunked upload always commits the session at the end.
object
Media source information. Only on OneDrive for Business and SharePoint.
string
An ETag value to prevent lost updates. If provided, the update will only proceed if the current file’s ETag matches this value. Returns 412 error if it doesn’t match.
object
File system information on client.
string ("replace" | "fail" | "rename")
How to handle conflicts when updating the file. ‘replace’ overwrites the existing content (default), ‘fail’ returns an error if conflict occurs, ‘rename’ creates a new file with a different name.
object
Information about the drive item source. Only on OneDrive for Business and SharePoint.
string
An ETag value to prevent updates if the item already exists. If provided and the ETag matches, returns 412 error. Used to detect if the item has changed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UPDATE_SHAREPOINT_ITEM_PERMISSIONUpdate an application permission on a SharePoint list or list item using Microsoft Graph beta.

Input Parameters

array
required
Roles to set on the permission, such as read or write.
string
Optional SharePoint list item ID. Provide this to update a list-item permission; omit it to update a list-level permission.
string
required
The unique Microsoft Graph ID of the SharePoint list.
string
required
The Microsoft Graph SharePoint site ID in composite format, usually ‘hostname,site-collection-id,web-id’.
string
required
The Microsoft Graph permission ID to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UPDATE_SHAREPOINT_LIST_ITEM_FIELDSUpdate field values on a SharePoint list item using Microsoft Graph through the OneDrive connection. Use when you need to modify one or more columns on an existing SharePoint list item.

Input Parameters

object
required
Field values to update, keyed by SharePoint internal column name. Only supplied fields are changed; all other list item fields are left as-is.
string
required
The unique ID of the SharePoint list item to update.
string
required
The unique Microsoft Graph ID of the SharePoint list that contains the item. Use ONE_DRIVE_LIST_SITE_LISTS to find list IDs.
string
required
The Microsoft Graph SharePoint site ID in composite format, usually ‘hostname,site-collection-id,web-id’.
string
Optional eTag for optimistic concurrency. If provided and it does not match the current list item eTag, Microsoft Graph returns 412 Precondition Failed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UPDATE_TABLE_COLUMN_RANGEUpdate values, formulas, number formats, or row and column visibility in a table column’s whole or data-body range.

Input Parameters

array
Two-dimensional array of raw values to write.
string
required
DriveItem ID of the Office Open XML workbook.
string
required
Drive containing the workbook. Use ‘me’ for the connected user’s drive, or provide a Microsoft Graph drive ID.
array
Two-dimensional array of A1-style formulas or literal values to write.
string ("whole_column" | "data_body")
Use data_body for data rows only, or whole_column to include the table column’s header and totals ranges.
boolean
Whether all rows in the range should be hidden.
string
Optional workbook session ID returned by ONE_DRIVE_CREATE_WORKBOOK_SESSION.
integer
required
Zero-based index of the table column to update.
boolean
Whether all columns in the range should be hidden.
array
Two-dimensional array of R1C1-style formulas or literal values to write.
array
Two-dimensional array of Excel number format strings to write.
array
Two-dimensional array of A1-style formulas or literal values in the user’s language and number-formatting locale.
string
required
Exact table ID or table name in the workbook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UPDATE_WORKBOOK_RANGEUpdates a range in a workbook worksheet using Microsoft Graph API. Use this action when you need to write data, formulas, or number formats to specific cells in an Excel workbook stored in OneDrive or SharePoint. The address parameter supports various formats including single cells, cell ranges, entire columns, or entire rows.

Input Parameters

array
Optional 2D array containing values to write to the range. Array dimensions must match or be smaller than the range. At least one of values, formulas, or number_format must be provided.
string
required
The range address in A1 notation. Supports single cell (e.g., ‘A1’), range (e.g., ‘A1:B5’), entire column (e.g., ‘A:A’), or entire row (e.g., ‘1:1’).
string
required
The ID of the workbook item
string
required
The ID of the drive containing the workbook
array
Optional 2D array containing formulas to set. If both formulas and values are provided, formulas take precedence.
string
Optional workbook session ID to use via the Workbook-Session-Id request header.
array
Optional 2D array containing number format strings
string
required
The ID or name of the worksheet

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_UPDATE_WORKBOOK_WORKSHEETUpdates properties of a worksheet in an Excel workbook stored in OneDrive. Use this action when you need to rename a worksheet, change its position (tab order), or modify its visibility state. At least one of name, position, or visibility must be provided in the request. The worksheet is identified by its ID or display name within the specified workbook.

Input Parameters

string
The new display name for the worksheet.
string
required
The ID of the workbook item (Excel file) containing the worksheet.
string
required
The ID of the drive containing the workbook.
integer
The new zero-based position of the worksheet in the workbook.
string
Optional workbook session ID. Use this to make changes in an existing Excel workbook session.
string ("Visible" | "Hidden" | "VeryHidden")
Worksheet visibility state.
string
required
The ID or name of the worksheet to update. Will be URL-encoded automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ONE_DRIVE_WRITE_WORKBOOK_CELLUpdates the value, formula, or format of a specific cell in an Excel workbook stored in OneDrive. Use this action when you need to write data to a single cell at a specific row and column position. The row and column parameters are 0-indexed (row 0 is the first row, column 0 is column A).

Input Parameters

integer
required
The row number of the cell (0-indexed). Row 0 is the first row in the worksheet.
integer
required
The column number of the cell (0-indexed). Column 0 is the first column (A) in the worksheet.
array
Optional 2D array containing the value to write to the cell. Must be a single-cell array like [['new value']]. At least one of values, formulas, or number_format must be provided.
string
required
The ID of the workbook item (Excel file) in OneDrive.
string
required
The ID of the drive containing the workbook. Use ‘me’ for the user’s default OneDrive, or specify a SharePoint drive ID.
array
Optional 2D array containing a formula to set in the cell (e.g., [['=SUM(A1:A10)']]). If provided, this takes precedence over values.
string
Optional workbook session ID. If provided, changes are grouped in a session for better consistency. Must be a valid session ID from a createSession call.
array
Optional 2D array containing the number format string for the cell (e.g., [['0.00']] for two decimal places, [['mm-dd-yyyy']] for dates).
string
required
The ID or name of the worksheet where the cell is located. Can be the worksheet name (e.g., ‘Sheet1’) or its unique ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: ONE_DRIVE_BASE_TRIGGERType: pollBase trigger for OneDrive changes using Gmail-style state management. Subclasses override filter_changes(...) to extract only the relevant items.

Configuration

string
The path in OneDrive to monitor for changes. Default is root.
boolean
Whether to include deleted items in the changes
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
required
Type of change event (created, modified, deleted)
object
required
The OneDrive item that changed
Slug: ONE_DRIVE_FILE_CREATED_TRIGGERType: pollTriggers when a new file is created in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.

Configuration

string
The path in OneDrive to monitor for changes. Default is root.
boolean
Whether to include deleted items in the changes
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
required
Type of change event (created, modified, deleted)
object
required
The OneDrive item that changed
Slug: ONE_DRIVE_FILE_UPDATEDType: pollTrigger that fires when a OneDrive file’s content or metadata changes. Returns file ID, last modified time, and modifier info.

Configuration

string
The path in OneDrive to monitor for file updates. Use ’/’ for root or a subpath like ‘Documents/Reports’.
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
required
The ID of the updated file
string
The ISO8601 timestamp when the file was last modified
object
Information about who last modified the file
Slug: ONE_DRIVE_FOLDER_CREATED_TRIGGERType: pollTriggers when a new folder is created in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.

Configuration

string
The path in OneDrive to monitor for changes. Default is root.
boolean
Whether to include deleted items in the changes
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
required
Type of change event (created, modified, deleted)
object
required
The OneDrive item that changed
Slug: ONE_DRIVE_ITEM_DELETED_TRIGGERType: pollTriggers when a file or folder is deleted in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.

Configuration

string
The path in OneDrive to monitor for changes. Default is root.
boolean
Whether to include deleted items in the changes
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
required
Type of change event (created, modified, deleted)
object
required
The OneDrive item that changed
Slug: ONE_DRIVE_ITEM_MOVED_OR_RENAMED_TRIGGERType: pollTriggers when a file or folder is moved to a different path or renamed in OneDrive. Includes both old and new path/name data in the payload.

Configuration

string
The path in OneDrive to monitor for moves/renames. Default is root.
boolean
Whether to include files in move/rename detection.
boolean
Whether to include folders in move/rename detection.
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
required
Event type: renamed, moved, or moved_and_renamed
string
required
The unique identifier of the item
string
required
Type of the item: file or folder
string
Current name of the item
string
Current parentReference.path of the item
string
Previous name of the item
string
Previous parentReference.path of the item
object
Full OneDrive payload
string
Web URL of the item
Slug: ONE_DRIVE_ITEM_UPDATED_TRIGGERType: pollTriggers when an existing file or folder is modified in OneDrive. Uses Gmail-style state management and only detects actual modifications, not new creations.

Configuration

string
The path in OneDrive to monitor for changes. Default is root.
boolean
Whether to include deleted items in the changes
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
required
Type of change event (created, modified, deleted)
object
required
The OneDrive item that changed
Slug: ONE_DRIVE_NEW_VERSION_CREATED_TRIGGERType: pollTrigger that fires when a new version of a specified OneDrive file is created.

Configuration

string
The unique identifier of the drive. Optional; defaults to /me if not provided.
string
The unique identifier of the group. Mutually exclusive with other scope IDs.
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
required
The unique identifier of the OneDrive file to monitor.
string
The unique identifier of the site. Mutually exclusive with other scope IDs.
string
The unique identifier of the user. Mutually exclusive with other scope IDs.

Payload

string
required
The ID of the OneDrive file.
string
required
The ISO 8601 timestamp of when this version was last modified.
string
required
The version number/ID as returned by Microsoft Graph (e.g., ‘2.0’).
Slug: ONE_DRIVE_SHARING_PERMISSION_CHANGED_TRIGGERType: pollSharing Permission Added or Removed

Configuration

string
Drive ID if monitoring an item outside the signed-in user’s default drive.
string
Group ID if the item resides in a group’s drive.
boolean
If true, the trigger will also fire when roles are changed on an existing permission (e.g., from read to write).
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
The unique identifier of the OneDrive item to monitor for permission changes.
string
Alternative to item_id. Path relative to drive root in the form ’:/path/to/item:/’
string
SharePoint Site ID if the item resides in a site’s drive.
string
User ID if the item resides in a specific user’s drive.

Payload

array
Users/groups/apps affected by this change
string
required
permission_added | permission_removed | permission_updated
string
required
The OneDrive item ID whose sharing changed
Sharing link details, if any
string
required
The permission ID involved in the change
array
The roles before the change (for updated)
array
The roles after the change (for added/updated)