PrecisionBook a discovery call
Menu

OneDrive for AI agents

Agents read OneDrive at once. Changes and sends are held for a person's approval by default.

Book a discovery callBrowse all connectors

About OneDrive

OneDrive is Microsoft’s cloud storage solution enabling users to store, sync, and share files across devices, offering offline access, real-time collaboration, and enterprise-grade security

What an agent can do in OneDrive

Every OneDrive action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in OneDrive without asking first. 49 actions.

  • Get DriveRetrieves the properties and relationships of a Drive resource by its unique ID. Use this action when you need to get details about a specific OneDrive, user's OneDrive, group's document library, or a
  • Get DriveItem by Sharing URLTool to resolve a OneDrive/SharePoint sharing URL (or shareId) to a DriveItem with driveId and itemId. Use when you have a sharing link from Teams, chat, or 1drv.ms and need the item's metadata or IDs
  • Get Drives FollowingTool 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.
  • 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.
  • Get Item MetadataRetrieves 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
  • Get Item PermissionsRetrieves the permissions of a DriveItem by its unique ID within a specific Drive. Use when you need to check who has access to a file or folder and what level of access they have. Response nests perm
  • 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`); thumb
  • 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
  • Get Drive Root FolderTool to retrieve metadata for the root folder of the signed-in user's OneDrive. Use when you need information about the user's OneDrive root directory, such as size, child count, or web URL.
  • 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.
  • Get Site DetailsRetrieves 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.
  • Get SharePoint 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.
Show all 49
  • Get User ProfileRetrieves the properties and profile information for a specific Microsoft user by their user ID or user principal name. Use this action when you need to get detailed information about a user's profile
  • Inspect Workbook TableRead a workbook table's occupied range and one page of its columns.
  • List Drive 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.
  • 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 wi
  • List Drive 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.
  • 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_SEAR
  • List Root Drive ChangesTool to list changes in the root of the user's primary drive using a delta token. Use when you need to track file and folder modifications, additions, or deletions in the main OneDrive directory. Firs
  • List SharePoint Item PermissionsList Microsoft Graph beta permissions from a SharePoint list or list item.
  • 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 collec
  • 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.
  • List Site Drive 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
  • 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
  • List Site SubsitesTool to list all subsites of a SharePoint site. Use when you need to retrieve a collection of subsites for a given parent site. IMPORTANT: This action only works with organizational Microsoft 365 acco
  • List SubscriptionsTool to list the current subscriptions for the authenticated user or app. Use this to retrieve details of existing webhook subscriptions. Results may span multiple drives and resources; filter client-
  • 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 ne
  • 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 t
  • 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
  • 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-
  • Search ItemsSearch OneDrive for files and folders by keyword. Searches filenames, metadata, and file content to find matching items. Use when you need to find specific files based on keywords, file types, or cont
  • Search SharePoint SitesSearch SharePoint sites visible to an organizational Microsoft account.
  • 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
  • Get Drive Item List ItemRetrieve the SharePoint list item associated with a driveItem.
  • Get Item by PathRetrieve OneDrive or SharePoint driveItem metadata by drive-relative path.
  • Get Shared Item by ShareIdTool 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
  • Get Drive 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.
  • Get Workbook Range FillRead the fill color applied to an Excel worksheet range.
  • 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
  • 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 i
  • 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. Th
  • List Drive 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.
  • 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 d
  • List Shares PermissionTool 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
  • 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.
  • Find ItemNon-recursively finds an item (file or folder) in a specified OneDrive folder; if `folder` is provided as a path, it must actually exist. Results in large folders may be paginated via `@odata.nextLink
  • Find FolderFinds folders by name within an accessible parent folder in OneDrive, or lists all its direct child folders if no name is specified. Search is non-recursive: only immediate children of `folder` are ch
  • List OneDrive itemsRetrieves one page of files and folders as `driveItem` resources from the root of a specified user's OneDrive. Returns up to `top` items plus a `next_page_token`; pass that token back as `page_token`
  • Track Folder ChangesTrack changes beneath one folder, one Microsoft Graph delta page at a time.

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 39 actions.

  • Check In Drive 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 SharePoin
  • Checkout Drive 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.
  • Close Workbook SessionClose an Excel workbook session without deleting the workbook.
  • Copy ItemTool to copy a DriveItem (file or folder) to a new location asynchronously. Use when you need to duplicate an item, optionally renaming it or specifying a different parent folder. The operation is asy
  • Create Drive 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 permis
  • Create Sharing LinkTool to create a sharing link for a DriveItem (file or folder) by its unique ID. Use when you need to generate a shareable link for an item in OneDrive or SharePoint.
  • 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.
  • Create Workbook SessionCreate a persistent or temporary session for an Excel workbook.
  • Delete ItemTool to delete a DriveItem (file or folder) by its unique ID from the authenticated user's OneDrive. Use when you need to remove an item from OneDrive. This action moves the item to the recycle bin, n
  • Permanently Delete Drive ItemTool 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 undo
  • Delete Drive 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.
  • Delete Shares 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.
Show all 39
  • Delete SharePoint Item PermissionRevoke a Microsoft Graph beta permission from a SharePoint list or list item.
  • 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 OneDri
  • 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.
  • Grant Shares 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.
  • Grant SharePoint Item PermissionGrant an application permission on a SharePoint list or list item using Microsoft Graph beta.
  • Invite User to Drive ItemTool to invite users or grant permissions to a specific item in a OneDrive drive. Use when you need to share a file or folder with other users and define their access level (e.g., read or write).
  • 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.
  • Restore Deleted 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 ren
  • 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 restora
  • Delete Drive FollowingTool 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.
  • 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.
  • Update Drive Item 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.
  • Update SharePoint Item PermissionUpdate an application permission on a SharePoint list or list item using Microsoft Graph beta.
  • 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.
  • Update Table Column RangeUpdate values, formulas, number formats, or row and column visibility in a table column's whole or data-body range.
  • 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. Th
  • 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
  • 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
  • Delete Workbook RangeDeletes a range of cells from a worksheet in an Excel workbook stored in OneDrive. Use this action when you need to remove a specific cell range and shift the remaining cells to fill the gap. This act
  • 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
  • Follow Drive 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.
  • 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 ac
  • Create a new text fileCreates a new plain-text file with specified content in the authenticated user's personal OneDrive, using either the folder's unique ID or its absolute path relative to the user's OneDrive root (paths
  • Upload fileUploads a file to a specified OneDrive folder, automatically creating the destination folder if it doesn't exist, renaming on conflict, and supporting large files via chunking.
  • 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). Wh
  • 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
  • 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 leas

Changes wait in Needs you

Changes and sends in OneDrive are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

OneDrive questions

Can an agent change data in OneDrive on its own?

Not by default. Changes and sends in OneDrive are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in OneDrive?

This connector lists 49 read actions. Reads run at once, without waiting for approval.

How does OneDrive connect?

It connects with OAuth 2.0 or Server-to-server OAuth. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring OneDrive to your agents.

Book a discovery call