Team
Shared credential for production and unattended runs.
Connect OneDrive with Hookshot™ and your stack
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
Tools and triggers
What Agents can do in OneDrive
Available tools and events after OneDrive is connected.
-
Add Workbook Worksheet
Adds 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…
-
Check in Drive Item
Tool 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.
-
Checkout Drive Item
Tool 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.
-
Clear Workbook Range
Clears 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…
-
Copy Item
This action allows users to copy a DriveItem, which can be a file or folder, to a new location asynchronously. Users can optionally rename the copied item or specify a different parent folder for the copy.
-
Create a New Text File
This action allows users to create a new text file in a specified folder within their personal OneDrive. Users can provide the content and the desired file name, and the file will be uploaded to their OneDrive. Note…
-
Create Drive Item Permission
Tool 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…
-
Create Folder
This action creates a new folder in OneDrive. It supports configurable Microsoft Graph conflict behavior and allows specifying a parent folder for organization.
-
Create SharePoint List Item
Creates a new item in a SharePoint list using Microsoft Graph. Provide the SharePoint site ID, list ID, and the field values to store.
-
Create Sharing Link
This action creates a sharing link for a specified drive item by using its unique identifier. Users can generate view, edit, or embed links for items in OneDrive or SharePoint. Choose the link scope explicitly: if…
-
Delete Drive Following
Tool 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.
-
Delete Drive Item Permission
Tool 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 Item
This action deletes a specified DriveItem from the user's OneDrive. It moves the item to the recycle bin rather than permanently removing it, allowing for potential recovery.
-
Delete SharePoint Item Permission
Revoke a Microsoft Graph beta permission from a SharePoint list or list item.
-
Delete Shares Permission
Tool 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.
-
Delete Workbook Range
Deletes 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 action is…
-
Delete Workbook Worksheet
Deletes 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…
-
Discard Checkout
Tool 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.
-
Download a File
This action retrieves a specific file from a user's OneDrive based on the provided item ID. The user can specify the desired filename for the downloaded content.
-
Download Drive Item Version Content
Tool 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…
-
Download File by Path
Downloads 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.
-
Download Item as Format
Tool 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…
-
Find Folder
This action allows users to search for specific folders by name within a given parent folder in OneDrive. If the name is not provided, it retrieves all direct child folders of the specified parent directory.
-
Find Item
This action searches for a specific item, either a file or folder, within a designated OneDrive folder. Users can use this function to locate items by providing the item's name and the folder where the search should…
-
Follow Drive Item
Tool 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.
-
Get Document Comments
Extract comments from a Word .docx file stored in OneDrive and return structured JSON that agents can reason over.
-
Get Drive
Retrieves detailed information about a drive, including its properties and relationships. This action can be used to access data related to a user's drive, a group's document library, or a site collection's drive.
-
Get Drive Root Folder
Tool 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 Drive Special Folder
Tool 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 DriveItem by Sharing URL
Tool 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 for downstream…
-
Get Drives Following
Retrieves metadata for a specific driveItem (file or folder) that is being followed by the signed-in user. This action returns details including follow status, timestamps, and item properties.
-
Get Group Drive
Tool 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 Metadata
Retrieves metadata for a specific DriveItem using its unique identifier. This action can return information about either files or folders stored in OneDrive.
-
Get Item Permissions
Retrieves the permissions for a specified drive item in a drive. It allows users to find out which identities have access to that item and the permissions granted to them.
-
Get Item Thumbnails
Retrieves thumbnails for a specified DriveItem, allowing the caller to preview the associated images. This action is useful for displaying visual representations of files directly in the UI.
-
Get Item Versions
This action retrieves the version history of a specific DriveItem identified by its unique ID. It allows users to access or list previous versions of files or folders within the specified context.
-
Get Shared Item by ShareId
Tool 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…
-
Get SharePoint List Items
Retrieves items from a specific SharePoint list based on the provided site and list IDs. The action allows for optional expansions, filtering, and selection of specific fields in the response.
-
Get SharePoint Site Page Content
Retrieves the content and details of a specific site page from a SharePoint site. This action allows you to obtain information such as the page's layout, title, and other pertinent data for display or processing.
-
Get Site Details
Retrieves details about a SharePoint site. Specifically, it provides the site's display name, URL, and timestamps for creation and last modification.
-
Get User Profile
Retrieves 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, including their…
-
Get Workbook Used Range
Retrieves 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…
-
Get Workbook Worksheet
Retrieves 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…
-
Grant SharePoint Item Permission
Grant an application permission on a SharePoint list or list item using Microsoft Graph beta. This endpoint does not create user permissions.
-
Grant Shares Permission
Tool 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.
-
Invite User to Drive Item
This action allows you to invite users to access a specific drive item in OneDrive. You can specify their roles and whether to send an invitation, making file sharing more manageable.
-
List All Drive Items
Lists 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…
-
List Drive Activities
Tool 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 Drive Bundles
This action retrieves a list of bundles (collections of files like photo albums) from a OneDrive drive. It supports filtering, pagination, and ordering to help you find specific bundles.
-
List Drive Item Activities
This action retrieves a list of recent activities performed on a specified item within a OneDrive drive. It is useful for tracking modifications or interactions with files and folders.
-
List Drives
This action retrieves a list of Drive resources in OneDrive. It can return drives for a specific user, group, or site, and is useful for understanding accessible storage options.
-
List Folder Children
This action lists all files and folders directly inside a specified OneDrive or SharePoint folder. You can specify the folder by its unique ID or by path. It supports pagination for large folders, making it ideal for…
-
List OneDrive Items
This action fetches one page of files and folders from the root of the user's OneDrive. It returns up to `top` items and a continuation token; pass the token back as `page_token` to walk through a large drive one page…
-
List OneDrive Shared Items
List files shared from other people's OneDrive accounts. This uses a OneDrive-specific heuristic and excludes SharePoint-site shares.
-
List Root Drive Changes
This action retrieves changes made to the root of the user's drive. It allows you to track modifications, additions, or deletions in the main OneDrive directory based on a delta token.
-
List SharePoint Item Permissions
List Microsoft Graph beta permissions from a SharePoint list or list item.
-
List SharePoint List Items Delta
Retrieves changes to items in a SharePoint list using a delta query. It allows the user to track newly added, modified, or deleted items efficiently.
-
List Shares Permission
Tool 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.
-
List Site Columns
This action retrieves the definitions of all columns in a specified SharePoint site. You can use it to understand the structure of the columns and their properties.
-
List Site Drive Items Delta
This action retrieves delta changes for DriveItems within a SharePoint site's default document library. It allows users to track additions, modifications, and deletions of items since a specified token or state.
-
List Site Lists
This action retrieves all the lists from a specified SharePoint site. It allows users to obtain details about each list, such as its name and metadata. NOTE: This action requires a Microsoft 365 organizational account…
-
List Site Subsites
This action retrieves all subsites associated with a specified SharePoint site. It provides details such as subsite ID, name, and URL to help manage site hierarchies. NOTE: This action requires a Microsoft 365…
-
List Subscriptions
This action retrieves the current webhook subscriptions for a specific user or application. It allows clients to see which resources they are monitoring for changes.
-
List Workbook Worksheets
Retrieves 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…
-
Move Item
This action moves a specified file or folder to a new parent location in OneDrive. It allows for optional renaming of the item during the operation.
-
Permanently Delete Drive Item
Tool 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.
-
Preview Drive Item
This action generates or retrieves a temporary embeddable preview URL for a specific Drive item. It allows users to access and display file previews without direct file access.
-
Read Workbook Range
Reads 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…
-
Restore Deleted Item
Tool 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…
-
Restore Item Version
Restores 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…
-
Search Drive Items
Search files and folders across OneDrive and accessible SharePoint locations using Microsoft Graph Search.
-
Search Items
This action performs keyword-based searches across OneDrive files and folders. It searches through filenames, file content, and metadata to find items matching your query. Ideal for locating specific documents when you…
-
Update Drive Item Metadata
This action updates metadata for a specified OneDrive item. It can change the item's name, description, or its parent folder location.
-
Update Drive Item Permissions
Tool 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 File Content
Tool 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…
-
Update SharePoint Item Permission
Update an application permission on a SharePoint list or list item using Microsoft Graph beta. This endpoint does not update user permissions.
-
Update SharePoint List Item Fields
Updates field values on an existing SharePoint list item using Microsoft Graph. Only the provided fields are changed.
-
Update Workbook Range
Updates 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…
-
Update Workbook Worksheet
Updates 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…
-
Upload File
This action allows users to upload a file to their OneDrive account. It automatically creates the destination folder if it doesn't exist (including nested paths), manages file conflicts by renaming if necessary, and…
-
Write Workbook Cell
Updates 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…
-
File Updated
Trigger that fires when a OneDrive file's content or metadata changes. Returns file ID, last modified time, and modifier info.
-
Item Moved or Renamed
Triggers 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.
-
New Version Created
Trigger that fires when a new version of a specified OneDrive file is created.
-
OneDrive File Created Trigger
Triggers when a new file is created in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.
-
OneDrive Folder Created Trigger
Triggers when a new folder is created in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.
-
OneDrive Item Deleted Trigger
Triggers when a file or folder is deleted in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.
-
OneDrive Item Updated Trigger
Triggers when an existing file or folder is modified in OneDrive. Uses Gmail-style state management and only detects actual modifications, not new creations.
-
Onedrivebasetrigger
Base trigger for OneDrive changes using Gmail-style state management. Subclasses override `filter_changes(...)` to extract only the relevant items.
-
Sharing Permission Added or Removed
Sharing Permission Added or Removed
Setup
Connect OneDrive in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
