# OneDrive Your Toolhouse AI Worker can connect to One Drive using 60 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=one_drive). ## Tools (60) ### `One Drive Checkin Item` Integration name: **ONE\_DRIVE\_CHECKIN\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | `comment` | string | | `"Updating the latest guidelines"` | A check-in comment that is associated with the version. | | `drive_id` | string | ✅ | `"b!sAYRj4psj0qqpjB3OOHdglZBMF5Nk0xPnR4Fc4pfinI7DA8OPuKvSo4igDo7VyMV"` | The unique identifier of the drive containing the item to check in. | | `check_in_as` | string | | `"published"` | Optional. The status of the document after the check-in operation is complete. Can be 'published' or unspecified. | | `drive_item_id` | string | ✅ | `"01K67O4VTWDINZFGZPTZFLNCNDHKWWTVVM"` | The unique identifier of the driveItem to check in. | *** ### `One Drive Checkout Item` Integration name: **ONE\_DRIVE\_CHECKOUT\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ---------------------------------------------------------------------- | -------------------------------------------------------------------- | | `drive_id` | string | ✅ | `"b!fkc7Pu0hi0Sn_lc7cY3F_488fj0zcS1LulNBjZ70i6vCTPG_IXC3Tp9kaFX6UuQp"` | The unique identifier of the drive containing the item to checkout. | | `drive_item_id` | string | ✅ | `"01LLJYZ3DDTIEQXG7AQNA27GC33MPBNEMN"` | The unique identifier of the driveItem (file or folder) to checkout. | *** ### `One Drive Copy Item` Integration name: **ONE\_DRIVE\_COPY\_ITEM** Tool 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 asynchronous; the response provides a URL to monitor the copy progress. Do not assume the copy is complete immediately; verify via ONE\_DRIVE\_GET\_ITEM or by listing the destination, especially for large folder trees. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------------------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | | `"new_document_copy.docx"` | 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. | | `item_id` | string | ✅ | `"01BYE5RZZ5OJQ5X6X1W4Q6V8T2Y4A8P7C5"` | The ID of the DriveItem to be copied. | | `site_id` | string | | `"contoso.sharepoint.com,2C712604-132D-4AC7-A58A-9919A6B0A862,D8A48A4A-274E-4494-8B2A-40E71A6E1D8A"` | The ID of the site if the item is in a SharePoint site. | | `user_id` | string | | `"024d423a-35ef-450e-9317-5669101788f0"` | The ID of the user if accessing another user's drive. | | `drive_id` | string | | `"b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop"` | The ID of the drive where the item is located. If not provided, 'me' (user's default drive) is assumed. | | `group_id` | string | | `"024d423a-35ef-450e-9317-5669101788f0"` | The ID of the group if the item is in a group drive. | | `children_only` | 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. | | `parent_reference` | 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`. | | `conflict_behavior` | string | | — | Specifies how to handle a naming conflict if an item with the same name already exists in the destination. 'fail' (default), 'replace', or 'rename'. | | `include_all_version_history` | boolean | | — | If set to true, the version history of the source file is copied to the destination. Defaults to false. | *** ### `One Drive Create Item Permission` Integration name: **ONE\_DRIVE\_CREATE\_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 SharePoint site group permissions only. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | `roles` | array | ✅ | `["write"]` | Array of roles to assign to the permission. Valid values: read, write, owner. | | `drive_id` | string | ✅ | `"b!sAYRj4psj0qqpjB3OOHdglZBMF5Nk0xPnR4Fc4pfinLYXvUneLOfS60CAyfNpnLO"` | The unique identifier of the drive. | | `drive_item_id` | string | ✅ | `"01K67O4VUBDQZACMZEPZG2QD5KV562YVWG"` | The unique identifier of the drive item. | | `granted_to_v2` | object | ✅ | — | The identity to grant permission to. Must contain either application or siteGroup property. | *** ### `One Drive Create Link` Integration name: **ONE\_DRIVE\_CREATE\_LINK** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------------ | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `type` | string | ✅ | — | The type of sharing link to create. Valid values: `view`, `edit`, `embed`. | | `scope` | string | | — | The scope of the link to create. If not specified, the default link type for the organization is created. Valid values: `view`, `edit`, `organization`, `anonymous`. Use `organization` to restrict to internal users; `anonymous` exposes content to anyone with the link. Tenant policies may block or downgrade certain scopes (e.g., `anonymous`), resulting in errors or more restrictive links than requested. | | `item_id` | string | ✅ | — | The unique identifier of the drive item (file or folder) for which to create the link. Note: Some item types cannot be shared, including embedded objects, certain system files, and items with restricted permissions. If sharing fails with 'notSupported' error, verify the item type supports sharing. | | `site_id` | string | | — | The unique identifier of the site. Use this if the item is in a SharePoint site's drive. | | `user_id` | string | | — | The unique identifier of the user. Use this if the item is in another user's drive. | | `drive_id` | string | | — | The unique identifier of the drive. If not provided, the link will be created in the current user's drive (me/drive). | | `group_id` | string | | — | The unique identifier of the group. Use this if the item is in a group's drive. | | `password` | string | | — | The password for the sharing link. Optional and OneDrive Personal only. | | `recipients` | array | | — | A list of recipients for the sharing link. Required when scope is 'users'. Each recipient should be a dict with an 'email' key, e.g. \[{'email': ''}]. | | `expiration_date_time` | string | | — | The expiration date and time for the permission, in yyyy-MM-ddTHH:mm:ssZ format. Example: 2023-12-31T23:59:59Z Must be a future UTC timestamp; past values will cause the call to fail. | | `retain_inherited_permissions` | boolean | | — | If true (default), existing inherited permissions are retained. If false, all existing permissions are removed when sharing for the first time. | *** ### `One Drive Delete Item` Integration name: **ONE\_DRIVE\_DELETE\_ITEM** Tool 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, not permanently deleting it; storage quota is not freed until the recycle bin is emptied. Bulk deletions can trigger 429 (rate limit) or 5xx responses — limit concurrency and use exponential backoff. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"01BYE5LBA66X3J2X2T2K2S2J2Y2T2K2S2J"` | The unique identifier of the DriveItem (file or folder) to be deleted. | | `user_id` | string | | `"user@example.com"` | The user's ID, email, or 'me'. Defaults to 'me' (authenticated user). Required for S2S (app-only) auth. | | `drive_id` | string | | `"b!C1N9xkeL9Ea4Y0bdYcYWjXn7b0Un2adItX1s59n5N7Y"` | 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. | | `if_match` | string | | `"abcdef1234567890"` | (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. | *** ### `One Drive Delete Item Permanently` Integration name: **ONE\_DRIVE\_DELETE\_ITEM\_PERMANENTLY** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"01LLJYZ3CTMC3NXG4WT5G2CTWDXL3ZRNRY"` | 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. | | `drive_id` | string | ✅ | `"b!fkc7Pu0hi0Sn_lc7cY3F_488fj0zcS1LulNBjZ70i6vCTPG_IXC3Tp9kaFX6UuQp"` | The unique identifier of the drive containing the item to permanently delete. | *** ### `One Drive Delete Item Permission` Integration name: **ONE\_DRIVE\_DELETE\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"01LLJYZ3BIVSH7CHY3XBD3HP7XUKUOEM4T"` | The unique identifier of the drive item (file or folder). | | `perm_id` | string | ✅ | `"aTowIy5mfG1lbWJlcnNoaXB8c2Ftdml0QGNvbXBvc2lvMjAyNC5vbm1pY3Jvc29mdC5jb20"` | The unique identifier of the permission to delete. Only non-inherited sharing permissions can be deleted. | | `site_id` | string | | `"contoso.sharepoint.com,2C712604-1397-42ED-85C7-5843590F0202,2D22A158-83D2-4D48-92C1-502810230D0A"` | The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site's drive. | | `user_id` | string | | `"024d426a-2f0f-4e9a-92c1-502810230d0a"` | The unique identifier of a user. Use this if the item is in a specific user's drive (other than 'me'). | | `drive_id` | string | | `"b!C1N9xkeL9Ea4Y0bdYcYWjXn7b0Un2adItX1s59n5N7Y"` | The unique identifier of the drive. If not provided, the action will target the user's personal OneDrive (me/drive). | | `group_id` | string | | `"024d426a-2f0f-4e9a-92c1-502810230d0a"` | The unique identifier of the group. Use this if the item is in a group's drive. | *** ### `One Drive Delete Share Permission` Integration name: **ONE\_DRIVE\_DELETE\_SHARE\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------ | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `shared_drive_item_id` | string | ✅ | `"u!aHR0cHM6Ly9jb21wb3NpbzIwMjQtbXkuc2hhcmVwb2ludC5jb20vOng6L2cvcGVyc29uYWwva2FyYW52YWlkeWFfYXV0aGtpdF9haS9JUURPT2NCVEx5RTFSWktVQkJGZ0YzZVZBUmI4Zk5XVjdhMUJidGQ1NDF2SEdXUQ"` | The share ID or base64-encoded sharing URL. This is the shareId returned from the createLink API response. Example format: u!aHR0cHM6Ly9jb21wb3NpbzIwMjQtbXkuc2hhcmVwb2ludC5jb20vOng6L2cvcGVyc29uYWwva2FyYW52YWlkeWFfYXV0aGtpdF9haS9JUURPT2NCVEx5RTFSWktVQkJGZ0YzZVZBUmI4Zk5XVjdhMUJidGQ1NDF2SEdXUQ | *** ### `One Drive Discard Checkout` Integration name: **ONE\_DRIVE\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | -------------------------------------- | ---------------------------------------------------------------------------- | | `drive_id` | string | ✅ | `"b!example-drive-id-placeholder"` | The unique identifier of the drive containing the item to discard checkout. | | `drive_item_id` | string | ✅ | `"01LLJYZ3DUIPEYQZBWWNCJ7J7BBKG2TVUU"` | The unique identifier of the driveItem (file or folder) to discard checkout. | *** ### `One Drive Download File` Integration name: **ONE\_DRIVE\_DOWNLOAD\_FILE** Downloads 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 fields: s3url (URL to fetch raw file bytes), mimetype, and name; raw file data is not returned directly. Parsing content from Excel, Word, PDF, or other formats requires additional tooling. The response also includes attachment.s3key, required when passing this file to downstream tools such as OUTLOOK\_SEND\_EMAIL or OUTLOOK\_CREATE\_DRAFT. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `format` | string | | `"pdf"` | 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. | | `item_id` | string | ✅ | `"1234567890ABC"` | Raw item ID only (e.g., '1234567890ABC'). Do not include URL fragments or query parameters like '\&cid=...' or '?param=...' from sharing links. | | `user_id` | string | | `"me"` | User's ID or User Principal Name (UPN), or 'me' for the authenticated user's OneDrive. Ignored when drive\_id is provided. | | `drive_id` | string | | `"b!C378D127A8A967E6"` | The ID of the drive containing the file. Required for SharePoint or OneDrive for Business drives. When provided, user\_id is ignored. | | `file_name` | string | ✅ | `"report.docx"` | Desired filename (including extension) for the downloaded content. | | `if_none_match` | string | | `"aQzlGRDlBMjdBRDQ5RUVCOTE3LjA"` | 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. | *** ### `One Drive Download File By Path` Integration name: **ONE\_DRIVE\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `user_id` | string | | `"user@example.com"` | The user's ID, email, or 'me'. Defaults to 'me' (authenticated user). Required for S2S (app-only) auth. | | `file_name` | string | ✅ | `"report.docx"` | Desired filename (including extension) for the downloaded content. | | `item_path` | string | ✅ | `"document.txt"` | 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. | *** ### `One Drive Download Item As Format` Integration name: **ONE\_DRIVE\_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 items by item\_id or by path, and can target specific drives via drive\_id. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------ | :------: | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `format` | string | ✅ | `"pdf"` | 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). | | `item_id` | string | | `"01K67O4VRWDSTKBPCK3ZGLBNUVXQ5WGFRC"` | The unique identifier of the driveItem to convert. If provided, this takes precedence over path\_and\_filename. | | `user_id` | string | | `"user@example.com"` | User's ID or User Principal Name (UPN), or 'me' for the authenticated user's OneDrive. Ignored when drive\_id is provided. | | `drive_id` | string | | `"b!sAYRj4psj0qqpjB3OOHdglZBMF5Nk0xPnR4Fc4pfinI7DA8OPuKvSo4igDo7VyMV"` | The unique identifier of the drive. Optional - use for SharePoint document libraries. If not provided, uses the default drive. | | `file_name` | string | ✅ | `"report.pdf"` | Desired filename (including extension) for the downloaded converted content. | | `path_and_filename` | string | | `"Documents/report.docx"` | 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. | *** ### `One Drive Download Item Version` Integration name: **ONE\_DRIVE\_DOWNLOAD\_ITEM\_VERSION** 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 versions. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"01K67O4VQGGYWPNRNWTFCIVSY6TCKQFCQB"` | The unique identifier of the drive item (file). Cannot be a folder ID. | | `drive_id` | string | | `"b!C1N9xkeL9Ea4Y0bdYcYWjXn7b0Un2adItX1s59n5N7Y"` | The unique identifier of the drive containing the file. If not provided, defaults to the user's personal OneDrive (me/drive). | | `file_name` | string | ✅ | `"report_v1.docx"` | Desired filename (including extension) for the downloaded version content. | | `version_id` | string | ✅ | `"1.0"` | 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. | *** ### `One Drive Follow Item` Integration name: **ONE\_DRIVE\_FOLLOW\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `drive_id` | string | ✅ | `"b!fkc7Pu0hi0Sn_lc7cY3F_488fj0zcS1LulNBjZ70i6vCTPG_IXC3Tp9kaFX6UuQp"` | 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. | | `driveItem_id` | string | ✅ | `"01LLJYZ3BIVSH7CHY3XBD3HP7XUKUOEM4T"` | 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. | *** ### `One Drive Get Drive` Integration name: **ONE\_DRIVE\_GET\_DRIVE** Retrieves 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 site's document library. Only drives accessible to the authenticated user are returned; missing drives indicate insufficient OAuth scope or tenant permissions. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `drive_id` | string | ✅ | `"b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7"` | 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. | | `expand_fields` | array | | `["root","list"]` | 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. | | `select_fields` | array | | `["id","name","driveType"]` | 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. | *** ### `One Drive Get Drive Item By Sharing Url` Integration name: **ONE\_DRIVE\_GET\_DRIVE\_ITEM\_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 actions like permissions or download. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------- | ------- | :------: | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sharing_url` | string | | `"https://1drv.ms/u/s!Asj_FKjfasdf"` | 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. | | `prefer_redeem` | string | | `"redeemSharingLinkIfNecessary"` | 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. | | `select_fields` | array | | `["id","name","size"]` | 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. | | `expand_children` | boolean | | — | If true and the item is a folder, expands the children collection to include child items in the response. | | `share_id_or_encoded_url` | string | | `"u!aHR0cHM6Ly8xZHJ2Lm1zL3UvcyFBc2pfRktqZmFzZGY"` | An already-encoded sharing token (prefixed with 'u!') or a shareId token from a previous API call. Mutually exclusive with sharing\_url. | *** ### `One Drive Get Followed Item` Integration name: **ONE\_DRIVE\_GET\_FOLLOWED\_ITEM** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `drive_id` | string | ✅ | `"b!fkc7Pu0hi0Sn_lc7cY3F_488fj0zcS1LulNBjZ70i6vCTPG_IXC3Tp9kaFX6UuQp"` | 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. | | `driveItem_id` | string | ✅ | `"01LLJYZ3F5QHHAJFBM6ZHIQLALLLTDLYHB"` | The unique identifier of the followed driveItem to retrieve. This is the ID of a specific file or folder that has been followed. | *** ### `One Drive Get Group Drive` Integration name: **ONE\_DRIVE\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `group_id` | string | ✅ | `"e063320c-cde3-49cf-a9ce-cad44aa44deb"` | The unique identifier of the group whose document library you want to retrieve. | | `select_fields` | array | | `["id","name","driveType"]` | 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. | *** ### `One Drive Get Item` Integration name: **ONE\_DRIVE\_GET\_ITEM** Retrieves 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------ | :------: | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK"` | 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, ONE\_DRIVE\_GET\_RECENT\_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. | | `drive_id` | string | | `"b!C1N9xkeL9Ea4Y0bdYcYWjXn7b0Un2adItX1s59n5N7Y"` | 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. | | `select_fields` | array | | `["id","name","size","file","folder","createdDateTime","lastModifiedDateTime"]` | 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. | | `expand_relations` | array | | `["children"]` | 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. | *** ### `One Drive Get Item Permissions` Integration name: **ONE\_DRIVE\_GET\_ITEM\_PERMISSIONS** Retrieves 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 permission entries under `data.value`; check top-level `success`/`error` flags before processing results. Results include inherited permissions, owner entries, and anonymous link entries — not just explicitly granted permissions. Sharing links may have differing scopes (org-only vs. anonymous); verify `link.scope` before treating a permission as externally accessible. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `select` | string | | `"id,roles,link"` | A comma-separated list of properties to include in the response. For example, 'id,roles,link'. | | `item_id` | string | | `"0123456789ABCDEF!123"` | 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. | | `site_id` | string | | `"contoso.sharepoint.com,2C712604-1397-42ED-85C7-5843590F0202,2D22A158-83D2-4D48-92C1-502810230D0A"` | The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site's drive. | | `user_id` | string | | `"024d426a-2f0f-4e9a-92c1-502810230d0a"` | The unique identifier of a user. Use this if the item is in a specific user's drive (other than 'me'). | | `drive_id` | string | | `"b!C1234567890ABCDEFGH"` | The unique identifier of the drive. Required if not using other identifiers like group\_id, site\_id, or user\_id in the path. | | `group_id` | string | | `"024d426a-2f0f-4e9a-92c1-502810230d0a"` | The unique identifier of a group. Use this if the item is in a group's drive. | | `item_path` | string | | `":/MyFolder/MyFile.txt:/"` | 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. | | `if_none_match` | string | | `"W/\"datetime'2024-01-15T12%3A00%3A00Z'\""` | If this request header value (etag) matches the current etag on the item, an HTTP 304 Not Modified response is returned. | *** ### `One Drive Get Item Thumbnails` Integration name: **ONE\_DRIVE\_GET\_ITEM\_THUMBNAILS** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `select` | string | | `"medium,large"` | 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. | | `item_id` | string | ✅ | `"01BYE5RZZ5S2R2YJ2V2XSW42X2YJ2V2XSW"` | The unique identifier of the DriveItem. | | `site_id` | string | | `"contoso.sharepoint.com,01234567-89ab-cdef-0123-456789abcdef,01234567-89ab-cdef-0123-456789abcdef"` | The unique identifier of a Site. Provide either drive\_id, group\_id, site\_id, or user\_id. | | `user_id` | string | | `"01234567-89ab-cdef-0123-456789abcdef"` | The unique identifier of a User. Provide either drive\_id, group\_id, site\_id, or user\_id. | | `drive_id` | string | | `"b!C1b_fJ0P9k6XwXkKzXkKzXkKzXkKzXkKzXkKzXkKzXkKzXkKzXkKzXkKzXkKzXkK"` | The unique identifier of the Drive. If not provided, 'me' will be used for the current user's drive. | | `group_id` | string | | `"01234567-89ab-cdef-0123-456789abcdef"` | The unique identifier of a Group. Provide either drive\_id, group\_id, site\_id, or user\_id. | | `original_orientation` | boolean | | — | If true, retrieves the thumbnail with its original EXIF orientation. This is only supported on OneDrive Personal. Defaults to false. | *** ### `One Drive Get Item Versions` Integration name: **ONE\_DRIVE\_GET\_ITEM\_VERSIONS** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"01BYE5RZZ5WNL2W2T7J7234P7R6IOF7M2M"` | The unique identifier of the item (file or folder). | | `site_id` | string | | `"contoso.sharepoint.com,2C712CB0-1531-4950-8391-53C884381F08,2C08C37A-CE38-4E8A-877A-B96EF858F078"` | The unique identifier of the site. Mutually exclusive with drive\_id, group\_id, and user\_id. | | `user_id` | string | | `"024d491a-1568-4b21-8302-5804e392b078"` | The unique identifier of the user. Mutually exclusive with drive\_id, group\_id, and site\_id. | | `drive_id` | string | | `"b!C1zX0a9GEE20kL9aMCxJjB"` | 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. | | `group_id` | string | | `"024d491a-1568-4b21-8302-5804e392b078"` | The unique identifier of the group. Mutually exclusive with drive\_id, site\_id, and user\_id. | *** ### `One Drive Get Recent Items` Integration name: **ONE\_DRIVE\_GET\_RECENT\_ITEMS** Get files and folders recently accessed by the user. Returns items based on activity history (opened, edited, viewed), sorted by most recent first — NOT by modification time; use ONE\_DRIVE\_ONEDRIVE\_LIST\_ITEMS or ONE\_DRIVE\_LIST\_ROOT\_DRIVE\_CHANGES for strictly modification-based queries. Use when you need to see what the user worked on recently (e.g., 'Show me files I worked on today'). Different from search - this tracks activity, not content. Results may contain duplicate names; disambiguate using lastModifiedDateTime, parentReference.path, and the file/folder property before acting on a specific item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `20` | Maximum number of recent items to return (1-200). Controls response size for better performance. Use pagination with @odata.nextLink for larger datasets. | | `select` | string | | `"id,name,webUrl,lastModifiedDateTime"` | 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. | *** ### `One Drive Get Root` Integration name: **ONE\_DRIVE\_GET\_ROOT** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `user_id` | string | | `"user@example.com"` | The user's ID, email, or 'me'. Defaults to 'me' (authenticated user). Required for S2S (app-only) auth. | | `select_fields` | array | | `["id","name","size","folder","webUrl"]` | 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. | *** ### `One Drive Get Share` Integration name: **ONE\_DRIVE\_GET\_SHARE** 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 shareId or sharing token and need information about what was shared. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------------------- | ------- | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `prefer_redeem` | string | | — | 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. | | `expand_children` | 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. | | `share_id_or_encoded_sharing_url` | string | ✅ | `"u!aHR0cHM6Ly9jb21wb3NpbzIwMjQtbXkuc2hhcmVwb2ludC5jb20vOng6L2cvcGVyc29uYWwva2FyYW52YWlkeWFfYXV0aGtpdF9haS9JUURPT2NCVEx5RTFSWktVQkJGZ0YzZVZBVEliM2JmcUhzNFNqaVp5S1E1UTVSOA"` | 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!'. Example: 'u!aHR0cHM6Ly9jb21wb3NpbzIwMjQtbXkuc2hhcmVwb2ludC5jb20vOng6L2cvcGVyc29uYWwva2FyYW52YWlkeWFfYXV0aGtpdF9haS9JUURPT2NCVEx5RTFSWktVQkJGZ0YzZVZBVEliM2JmcUhzNFNqaVp5S1E1UTVSOA' | *** ### `One Drive Get Shared Items` Integration name: **ONE\_DRIVE\_GET\_SHARED\_ITEMS** Tool to retrieve items shared with the authenticated user (not items the user has shared with others). Returns files and folders shared with the current user; response value array may be empty if no items exist. Use webUrl field from results for clickable links to items. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `allow_external` | boolean | | `true` | Set to true to include items shared from external tenants. Defaults to false, which only returns items shared within the user's own tenant. | *** ### `One Drive Get Sharepoint List Items` Integration name: **ONE\_DRIVE\_GET\_SHAREPOINT\_LIST\_ITEMS** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `50` | The maximum number of items to return in a single response. Used for pagination. | | `skip` | integer | | `20` | The number of items to skip in the result set. Used for pagination. | | `count` | boolean | | — | If true, returns the total count of items in the @odata.count property. | | `expand` | string | | `"fields($select=Name,Color,Quantity)"` | 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. | | `filter` | string | | `"fields/Quantity lt 600"` | An OData filter query to restrict the results. For example, to filter items where 'Quantity' is less than 600, use 'fields/Quantity lt 600'. | | `select` | string | | `"id,name,fields"` | A comma-separated list of properties to include in the response. Often used in conjunction with '$expand=fields(select=...)'. For example, 'id,name,fields'. | | `list_id` | string | ✅ | `"243bca4b-4e5e-45af-b37d-25f6135a740d"` | The unique identifier of the list within the SharePoint site. | | `orderby` | string | | `"fields/Name asc"` | OData order by expression to sort results. For example, 'fields/Name asc' or 'fields/Quantity desc'. | | `site_id` | string | ✅ | `"contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"` | The unique identifier of the SharePoint site. | *** ### `One Drive Get Site` Integration name: **ONE\_DRIVE\_GET\_SITE** Retrieves 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | `expand` | string | | `"columns,lists"` | Comma-separated list of relationships to expand in the response. Example: columns,lists,drives | | `select` | string | | `"id,displayName,webUrl"` | Comma-separated list of properties to include in the response. Example: id,displayName,webUrl | | `site_id` | string | ✅ | `"contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"` | The unique identifier of the SharePoint site. This is the id property of the site resource. | *** ### `One Drive Get Site Page Content` Integration name: **ONE\_DRIVE\_GET\_SITE\_PAGE\_CONTENT** Gets 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | `expand` | string | | `"canvasLayout"` | Expands related entities. For example, use 'canvasLayout' to include the page's layout and web part content. | | `select` | string | | `"id,name,title"` | Comma-separated list of properties to include in the response. Example: id,name,title | | `page_id` | string | ✅ | `"b575a07c-e9d9-4959-87a1-0e27ea020722"` | The unique identifier of the site page. | | `site_id` | string | ✅ | `"contoso.sharepoint.com,2C712414-2D96-4DB6-9A7C-27B7F651699E,A5DB89B3-59A8-45B6-9278-A843A5088E11"` | The unique identifier of the SharePoint site. | *** ### `One Drive Get Special Folder` Integration name: **ONE\_DRIVE\_GET\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------ | :------: | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `user_id` | string | | `"user@example.com"` | The user's ID, email, or 'me'. Defaults to 'me' (authenticated user). Required for S2S (app-only) auth. | | `select_fields` | array | | `["id","name","size","webUrl"]` | 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. | | `expand_relations` | array | | `["children"]` | 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'. | | `special_folder_name` | string | ✅ | `"documents"` | 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. | *** ### `One Drive Grant Share Permission` Integration name: **ONE\_DRIVE\_GRANT\_SHARE\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------ | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `roles` | array | ✅ | — | Array of role strings specifying the access level to grant: 'read' for view-only access or 'write' for edit access. | | `recipients` | array | ✅ | — | Array of recipient objects with email addresses who will receive access to the shared link. | | `encoded_sharing_url` | string | ✅ | — | 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. | *** ### `One Drive Invite User To Item` Integration name: **ONE\_DRIVE\_INVITE\_USER\_TO\_ITEM** Tool 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). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------------ | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `roles` | array | ✅ | — | Specifies the roles to be granted to the recipients. Options: 'read' (view-only), 'write' (edit), 'owner' (full control). | | `item_id` | string | ✅ | — | The unique identifier of the drive item (file or folder). | | `message` | string | | — | A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters. | | `site_id` | string | | — | The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site's drive. | | `user_id` | string | | — | The unique identifier of a user. Use this if the item is in another user's drive that you have access to. | | `drive_id` | string | | — | The unique identifier of the drive. If not provided, the authenticated user's personal drive (me/drive) will be used. | | `group_id` | string | | — | The unique identifier of a Microsoft 365 group. Use this if the item is in a group's drive. | | `password` | string | | — | The password set on the invite by the creator. Optional and OneDrive Personal only. | | `recipients` | array | ✅ | — | A collection of recipients who will receive access and the sharing invitation. | | `require_sign_in` | 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. | | `send_invitation` | boolean | | — | If true, a sharing link is sent to the recipient. Otherwise, a permission is granted directly without sending a notification. | | `expiration_date_time` | string | | — | Specifies the dateTime after which the permission expires. ISO 8601 format. Example: "2023-12-31T23:59:59.000Z" | | `retain_inherited_permissions` | 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. | *** ### `One Drive List Activities` Integration name: **ONE\_DRIVE\_LIST\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `25` | The maximum number of activities to return. Must be between 1 and 999. | | `drive_id` | string | | `"b!sAYRj4psj0qqpjB3OOHdglZBMF5Nk0xPnR4Fc4pfinLYXvUneLOfS60CAyfNpnLO"` | The ID of the drive to list activities for. If not provided, the default drive of the authenticated user (/me/drive) will be used. | *** ### `One Drive List Bundles` Integration name: **ONE\_DRIVE\_LIST\_BUNDLES** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `25` | The maximum number of items to return in a single page. Must be between 1 and 999. | | `expand` | string | | `"thumbnails"` | Comma-separated list of relationships to expand (e.g., 'children'). Note: expand=children is not supported for listing bundles. | | `filter` | string | | `"bundle/album ne null"` | OData filter query to filter bundles. For example, 'bundle/album ne null' to list only photo albums. | | `select` | string | | `"id,name,bundle"` | Comma-separated list of properties to include in the response (e.g., 'id,name,bundle'). | | `orderby` | string | | `"name desc"` | A comma-separated list of properties to order the results by, optionally followed by 'asc' or 'desc' (e.g., 'name desc'). | | `drive_id` | string | ✅ | `"b!sAYRj4psj0qqpjB3OOHdglZBMF5Nk0xPnR4Fc4pfinLYXvUneLOfS60CAyfNpnLO"` | The unique identifier of the drive to list bundles from. | | `skip_token` | string | | `"xxxxxxxx"` | A token used to retrieve the next page of results. | *** ### `One Drive List Drives` Integration name: **ONE\_DRIVE\_LIST\_DRIVES** Tool 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 — follow skip\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `25` | The maximum number of items to return in a single page. Must be between 1 and 999. | | `expand` | string | | `"root,list"` | Comma-separated list of relationships to expand (e.g., "root,list"). | | `select` | string | | `"id,name,driveType"` | Comma-separated list of properties to include in the response (e.g., "id,name,driveType"). | | `orderby` | string | | `"name desc"` | A comma-separated list of properties to order the results by, optionally followed by "asc" or "desc" (e.g., "name desc"). | | `site_id` | string | | `"contoso.sharepoint.com,2C712604-131D-49FC-857B-AF2775FC24E3,2D1C721E-289F-412A-96E9-ADD9707C0167"` | The ID of the site to list drives for. If provided, group\_id and user\_id should not be used. | | `user_id` | string | | `"48d31887-5fad-4d73-a9f5-3c356e68a038"` | 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. | | `group_id` | string | | `"80957564-4f36-480e-a079-99963a083854"` | The ID of the group to list drives for. If provided, site\_id and user\_id should not be used. | | `skip_token` | string | | `"xxxxxxxx"` | A token used to retrieve the next page of results. Results may be paginated; retrieve and pass this token repeatedly until no token is returned to ensure all drives are fetched. | *** ### `One Drive List Folder Children` Integration name: **ONE\_DRIVE\_LIST\_FOLDER\_CHILDREN** List the direct children (files/folders) of a OneDrive/SharePoint folder by DriveItem ID or path. Returns reliable pagination tokens/nextLink 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `top` | integer | | `50` | Maximum number of items to return per page. Default is 200. | | `expand` | array | | `["thumbnails"]` | List of relationships to expand in the response (e.g., \['thumbnails', 'permissions']). Use this to include related resources inline. | | `select` | array | | `["id","name","webUrl","size","lastModifiedDateTime"]` | Comma-separated list of properties to include in the response (e.g., \['id', 'name', 'size']). | | `orderby` | string | | `"name"` | Sort results by specified properties (e.g., 'name', 'lastModifiedDateTime desc'). | | `site_id` | string | | `"contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"` | If provided, uses /sites/{site-id}/drive/... route for SharePoint sites. | | `drive_id` | string | | `"b!C378D127A8A967E6"` | The ID of the drive. Required unless using 'use\_me\_drive' or 'site\_id' is provided. | | `next_link` | string | | — | Full @odata.nextLink URL from a previous response for pagination continuation. | | `skip_token` | string | | — | A $skipToken value from a previous response for pagination continuation. Alternative to 'next\_link'. | | `folder_path` | 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'. | | `use_me_drive` | boolean | | — | If true, uses /me/drive/... route for the authenticated user's personal OneDrive. | | `folder_item_id` | string | | `"01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K"` | 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. | *** ### `One Drive List Item Activities` Integration name: **ONE\_DRIVE\_LIST\_ITEM\_ACTIVITIES** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `top` | integer | | — | Show only the first n items. | | `skip` | integer | | — | Skip the first n items for pagination. | | `expand` | array | | — | List of relationships to expand in the response (e.g., \['driveItem', 'listItem']). Use this to include related resources inline. | | `filter` | string | | — | OData filter expression to filter activities (e.g., "activityDateTime gt 2023-01-01T00:00:00Z"). Allows filtering by date ranges or other criteria. | | `select` | array | | — | Comma-separated list of properties to include in the response (e.g., \['id', 'activityDateTime', 'actor']). Reduces payload size by returning only specified properties. | | `item_id` | string | ✅ | `"01BYE5RZZ5W2W6Z2X2Y7YF2X2Y7YF2X2Y7"` | The unique identifier of the driveItem. | | `orderby` | string | | — | Sort results by specified properties (e.g., 'activityDateTime desc' to show newest first, 'activityDateTime' for oldest first). | | `drive_id` | string | ✅ | `"b!C1zZc0a2F0K2Y8P0Z6X2Uw"` | The unique identifier of the drive. | *** ### `One Drive List Root Drive Changes` Integration name: **ONE\_DRIVE\_LIST\_ROOT\_DRIVE\_CHANGES** Tool 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. First call without `token` returns all current items plus an `@odata.deltaLink`; store that token and pass it on subsequent calls to retrieve only incremental changes. Losing the deltaLink token forces a full resync. Responses include deleted items (check `deleted` property) and the root item itself alongside files and folders. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `50` | Maximum number of items to return in a single response. Useful for pagination and controlling response size. | | `token` | string | | `"latest"` | 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. | | `expand` | string | | `"children"` | Comma-separated list of relationships to expand in the response. | | `select` | string | | `"id,name,folder,file"` | Comma-separated list of DriveItem properties to include in the response. Use this to retrieve specific fields and reduce response size. | | `drive_id` | string | | `"b!example-drive-id-placeholder"` | 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. | *** ### `One Drive List Share Permissions` Integration name: **ONE\_DRIVE\_LIST\_SHARE\_PERMISSIONS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------ | :------: | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `shared_drive_item_id` | string | ✅ | `"u!aHR0cHM6Ly9leGFtcGxlLnNoYXJlcG9pbnQuY29tL3BsYWNlaG9sZGVy"` | The share ID (encoded sharing URL in format u! 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. | *** ### `One Drive List Sharepoint List Items Delta` Integration name: **ONE\_DRIVE\_LIST\_SHAREPOINT\_LIST\_ITEMS\_DELTA** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `50` | Maximum number of items to return in a single response. | | `token` | string | | `"1230919asd190410jlka"` | 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. | | `expand` | string | | `"fields($select=ColumnA,ColumnB)"` | Comma-separated list of relationships to expand. Use 'fields($select=ColumnA,ColumnB)' format for field selection. | | `select` | string | | `"id,name,lastModifiedDateTime"` | Comma-separated list of listItem properties to return. | | `list_id` | string | ✅ | `"22e03ef3-6ef4-424d-a1d3-92a337807c30"` | The unique identifier of the list within the site. | | `site_id` | string | ✅ | `"contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"` | SharePoint site ID in composite format: hostname,site-collection-guid,site-guid (three comma-separated parts). | *** ### `One Drive List Site Columns` Integration name: **ONE\_DRIVE\_LIST\_SITE\_COLUMNS** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | — | The maximum number of items to return. | | `skip` | integer | | — | The number of items to skip in the result set. Used for pagination. | | `count` | boolean | | — | If true, returns the total count of items in the @odata.count property. | | `expand` | string | | `"sourceColumn"` | Comma-separated list of related resources to expand in the response. | | `filter` | string | | `"startswith(displayName,'Custom')"` | OData filter expression to apply to the results. | | `select` | string | | `"id,name,displayName"` | Comma-separated list of properties to include in the response. | | `orderby` | string | | `"displayName asc"` | Comma-separated list of properties used to sort the results. | | `site_id` | string | ✅ | `"contoso.sharepoint.com,2C712604-133D-4A7C-9194-F53CE4C952A2,A704AEF5-C2C0-43C3-A3D8-9F55A73A02E2"` | The unique identifier of the SharePoint site. Example: `contoso.sharepoint.com,2C712604-133D-4A7C-9194-F53CE4C952A2,A704AEF5-C2C0-43C3-A3D8-9F55A73A02E2` | *** ### `One Drive List Site Items Delta` Integration name: **ONE\_DRIVE\_LIST\_SITE\_ITEMS\_DELTA** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `50` | Maximum number of items to return in a single response. Useful for pagination and controlling response size. | | `token` | string | | `"https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C002417-A74E-4F5E-8786-3748AFF6941A,2C22A44A-725F-4959-8B9E-8ABA2197E7A4/drive/root/delta?$skiptoken=1230919asd190410jlka"` | 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). | | `expand` | string | | `"children"` | Comma-separated list of relationships to expand in the response. | | `select` | string | | `"id,name,folder,file"` | Comma-separated list of DriveItem properties to include in the response. Use this to retrieve specific fields and reduce response size. | | `site_id` | string | ✅ | `"contoso.sharepoint.com,2C002417-A74E-4F5E-8786-3748AFF6941A,2C22A44A-725F-4959-8B9E-8ABA2197E7A4"` | The unique identifier of the SharePoint site. | *** ### `One Drive List Site Lists` Integration name: **ONE\_DRIVE\_LIST\_SITE\_LISTS** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | — | The maximum number of items to return. | | `expand` | string | | `"columns,items"` | Comma-separated list of relationships to expand in the response. Example: columns,items | | `filter` | string | | `"startswith(name,'Doc')"` | OData filter expression. Example: startswith(name,'Doc') | | `select` | string | | `"id,name,list"` | Comma-separated list of properties to include in the response. Example: id,name,list | | `orderby` | string | | `"name asc"` | OData order by expression. Example: name asc | | `site_id` | string | ✅ | `"contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D4B0860-D7DE-419B-88E6-5866AF240000"` | 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. | *** ### `One Drive List Site Subsites` Integration name: **ONE\_DRIVE\_LIST\_SITE\_SUBSITES** Tool 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 accounts (Azure AD/Entra ID accounts). It is NOT supported for personal Microsoft accounts (MSA/Outlook.com/Hotmail accounts). Personal OneDrive users cannot access SharePoint sites through this endpoint. An empty `value` array in the response means the site has no subsites, not a failure. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | — | The maximum number of items to return. | | `expand` | string | | `"drive"` | Comma-separated list of relationships to expand in the response. | | `filter` | string | | `"startswith(name,'Project')"` | OData filter expression. Example: startswith(name,'Project') | | `select` | string | | `"id,name,webUrl"` | Comma-separated list of properties to include in the response. Example: id,name,webUrl | | `orderby` | string | | `"name asc"` | OData order by expression. Example: name asc, createdDateTime desc | | `site_id` | string | ✅ | `"contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740"` | 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. | *** ### `One Drive List Subscriptions` Integration name: **ONE\_DRIVE\_LIST\_SUBSCRIPTIONS** Tool 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-side by resource URL or type to narrow to a specific scope. An empty `value` array means no subscriptions exist, not a failed call. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `One Drive Move Item` Integration name: **ONE\_DRIVE\_MOVE\_ITEM** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `name` | string | | `"new-document.docx"` | 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. | | `itemId` | string | ✅ | `"01BYE5RZZ272Y2AM3L22L22Z2Y2Y2Y2Y2Y"` | The unique identifier of the file or folder (DriveItem) to be moved. | | `siteId` | string | | `"contoso.sharepoint.com,2C712604-132D-4AC7-A58A-9919A6B0A862,D8A48A4A-274E-4494-8B2A-40E71A6E1D8A"` | The unique identifier of the site if the item is in a SharePoint site. Mutually exclusive with drive\_id, group\_id, and user\_id. | | `userId` | string | | `"024d423a-35ef-450e-9317-5669101788f0"` | The unique identifier of the user if accessing another user's drive. Mutually exclusive with drive\_id, group\_id, and site\_id. | | `driveId` | string | | `"b!C1b2A3d4E5f6G7h8I9j0K1l2M3n4O5p6"` | The unique identifier of the Drive that contains the item. If not specified, it defaults to the user's personal drive (`/me/drive`). | | `groupId` | string | | `"024d423a-35ef-450e-9317-5669101788f0"` | The unique identifier of the group if the item is in a group drive. Mutually exclusive with drive\_id, site\_id, and user\_id. | | `description` | string | | `"Moved project proposal document."` | The new description for the drive item. If not provided, the item's description is not changed. | | `parentReference` | object | ✅ | `{"id":"01BYE5RZZ272Y2AM3L22L22Z2Y2Y2Y2Y2Y"}` | 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": "", "driveId": ""} (driveId is optional). Example: {"id": "01BYE5RZZ272Y2AM3L22L22Z2Y2Y2Y2Y2Y"}. Note: Folder names are not accepted - use the folder's unique ID obtained from listing or searching items. | *** ### `One Drive Onedrive Create Folder` Integration name: **ONE\_DRIVE\_ONEDRIVE\_CREATE\_FOLDER** Creates a new folder in the user's OneDrive, automatically renaming on conflict, optionally within a specified parent\_folder (by ID or full path from root) which, if not the root, must exist and be accessible. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | — | 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'] | | `user_id` | string | | `"user@example.com"` | The user's ID, email, or 'me'. Defaults to 'me' (authenticated user). Required for S2S (app-only) auth. | | `description` | string | | — | Optional description for the folder. Provides a user-visible description of the folder. Examples: \['Project documents for Q1 2024', 'Meeting notes archive'] | | `parent_folder` | 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', '/'] | *** ### `One Drive Onedrive Create Text File` Integration name: **ONE\_DRIVE\_ONEDRIVE\_CREATE\_TEXT\_FILE** Creates 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 are automatically resolved to IDs); note that OneDrive may rename or create a new version if the filename already exists. All files are written as plain text regardless of extension — specifying .docx or .xlsx does not produce a true Office document. This action only works with the user's personal OneDrive (/me/drive) and does not support SharePoint document libraries or shared drives. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `name` | string | ✅ | `"Annual Report 2023.txt"` | The desired name for the new text file, including its extension (e.g., 'report.txt', 'notes.log'). Also accepts 'file\_name' as an alias. | | `folder` | string | | `"/Documents/Projects"` | 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. | | `content` | string | ✅ | `"This is the content of the new text file."` | 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. | | `user_id` | string | | `"user_principal_name_or_id"` | The user's ID or the literal 'me' to represent the currently authenticated user. | | `conflict_behavior` | string | | `"fail"` | 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'). | *** ### `One Drive Onedrive Find File` Integration name: **ONE\_DRIVE\_ONEDRIVE\_FIND\_FILE** Non-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`; iterate all pages to avoid missing files. For searches where the subfolder is unknown, use ONE\_DRIVE\_SEARCH\_ITEMS instead. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------ | :------: | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"QuarterlyReport.docx"` | 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. | | `folder` | string | | `"/Documents/Projects"` | 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. | | `user_id` | string | | `"user_guid_example"` | 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. | | `response_detail` | string | | — | Level of detail in the response. 'minimal' (default) returns only essential properties (id, name, webUrl). 'full' returns complete metadata for each found item. | *** ### `One Drive Onedrive Find Folder` Integration name: **ONE\_DRIVE\_ONEDRIVE\_FIND\_FOLDER** Finds 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 checked, not deeper hierarchy levels. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `50` | Maximum number of items to return in a single request. When specified, auto-pagination is disabled and only one page is returned. Use with skip\_token to manually paginate through results. | | `name` | string | | `"Annual Reports"` | Exact name of the folder to find. If omitted, all direct child folders of the parent `folder` are returned. | | `expand` | string | | `"thumbnails"` | Comma-separated list of relationships to expand in the response (e.g., 'thumbnails', 'children'). See Microsoft Graph API documentation for supported expand properties. | | `folder` | string | | `"/Documents/Projects"` | Path (e.g., '/My Files/Work', '/' for root) or unique ID of the parent folder where child folders are searched. | | `select` | array | | `["id","name","webUrl","size","lastModifiedDateTime"]` | 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. | | `orderby` | string | | `"name"` | Sort results by specified properties (e.g., 'name', 'lastModifiedDateTime desc'). | | `user_id` | string | | `"user@example.com"` | User's unique identifier (e.g., email, UPN) or 'me' for the authenticated user, specifying the OneDrive account. | | `skip_token` | string | | — | A $skipToken value from a previous response for pagination continuation. When specified, auto-pagination is disabled and only the requested page is returned. | *** ### `One Drive Onedrive List Items` Integration name: **ONE\_DRIVE\_ONEDRIVE\_LIST\_ITEMS** Retrieves all files and folders as `driveItem` resources from the root of a specified user's OneDrive, automatically handling pagination. Non-recursive: returns only root-level items; subfolder contents require separate calls. Results may include `remoteItem` pointers (shared items from other drives) — use `remoteItem.driveId` and `remoteItem.id` for those in downstream calls. Distinguish files from folders by presence of `file` or `folder` property. Always use `id` values returned by this tool directly; never construct item IDs manually. Items may be absent from results due to permission restrictions, not drive absence. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `top` | integer | | `"20"` | Maximum items per API request, setting the batch size; the action automatically handles pagination to fetch all items. The Microsoft Graph API may limit this (e.g., to 999). | | `select` | array | | `"[\"id\", \"name\", \"webUrl\"]"` | 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. | | `user_id` | string | | `"me"` | User's unique identifier (e.g., '', object ID) or 'me' for the authenticated user's OneDrive. | *** ### `One Drive Onedrive Upload File` Integration name: **ONE\_DRIVE\_ONEDRIVE\_UPLOAD\_FILE** Uploads 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `file` | object | ✅ | — | The file to be uploaded, including its name and access to its binary content. | | `folder` | string | | `"/Documents/Projects"` | 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). | | `site_id` | string | | `"contoso.sharepoint.com,024d491a-4d09-4194-ae1f-7413535507dc,024d491a-4d09-4194-ae1f-7413535507dc"` | The unique identifier of the SharePoint site to upload to. If provided, uses /sites/{siteId}/drive. Mutually exclusive with drive\_id. | | `user_id` | string | | `"me"` | User ID (e.g., user\_principal\_name, unique GUID) or 'me' for the authenticated user, determining the target OneDrive. | | `drive_id` | string | | `"b!C3NkF4b2GU2msLpLqgZ4oYd_S4P0S6_FhG0bS-WpTkYwGVc_FmBYSZ7d0x_ZJpG-"` | 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. | | `description` | string | | `"Project proposal for Q1 2024"` | A user-visible description of the file. Only supported on OneDrive Personal. | | `defer_commit` | 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. | | `if_match_etag` | string | | `"aQzlGRDlBMjdBRDQ5RUVCOTE3LjA"` | 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. | | `file_system_info` | object | | — | File system information on client. | | `conflict_behavior` | string | | `"rename"` | 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. | *** ### `One Drive Preview Drive Item` Integration name: **ONE\_DRIVE\_PREVIEW\_DRIVE\_ITEM** Generates 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `page` | — | | `"1"` | Optional. Page number of document to start at, if applicable. Specified as string for future use cases around file types such as ZIP. | | `zoom` | number | | `0.5` | Optional. Zoom level to start at, if applicable. | | `item_id` | string | ✅ | `"01BYE56RBCN4TCN3ORBZZ3S22LMR4LKL2A"` | The unique identifier of the DriveItem. | | `site_id` | string | | `"contoso.sharepoint.com,2C712CB0-1531-4134-855A-67A093E71074,5A503C24-A59A-407C-BD5A-D392B8F7F000"` | The unique identifier of the Site. Provide if the item is in a SharePoint site. | | `user_id` | string | | `"024d4213-a6f0-4997-9010-217011398186"` | The unique identifier of the User. Provide if the item is in another user's drive. | | `drive_id` | string | | `"b!C1zX0j7x00G2vQj2foDUXn4xYp_XFVNKrjYpyIKs1x8"` | The unique identifier of the Drive. If not provided, the request will be made to the current user's drive. | | `group_id` | string | | `"024d4213-a6f0-4997-9010-217011398186"` | The unique identifier of the Group. Provide if the item is in a group drive. | | `share_id` | string | | `"s!Aln-sA4j5UeNpX1x92bAbS1bXn0Z"` | The unique identifier of the shared item. Provide if the item is accessed via a share link. | *** ### `One Drive Restore Drive Item` Integration name: **ONE\_DRIVE\_RESTORE\_DRIVE\_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 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------ | :------: | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | | `"restored-document.docx"` | (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. | | `item_id` | string | ✅ | `"01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK"` | 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. | | `drive_id` | string | | `"b!C3NkF4b2GU2msLpLqgZ4oYd_S4P0S6_FhG0bS-WpTkYwGVc_FmBYSZ7d0x_ZJpG-"` | 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. | | `parent_reference_id` | string | | `"01BYE5RZZ272Y2AM3L22L22Z2Y2Y2Y2Y2Y"` | (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. | *** ### `One Drive Search Items` Integration name: **ONE\_DRIVE\_SEARCH\_ITEMS** Search 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 content. Supports filtering, sorting, and pagination. Results are mixed files and folders — filter client-side using file vs folder properties. Disambiguate similarly named items using parentReference.path, lastModifiedDateTime, and size before passing item IDs downstream. Newly created or recently moved files may not appear due to indexing delays; fall back to ONE\_DRIVE\_LIST\_FOLDER\_CHILDREN if expected items are missing. No server-side date filtering — apply lastModifiedDateTime/createdDateTime filtering in your own logic. HTTP 429 responses include a Retry-After header; use exponential backoff. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------------- | ------- | :------: | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `q` | string | ✅ | `"Contoso Project"` | 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. | | `top` | integer | | — | The maximum number of items to return in a single page. Default is 200. | | `expand` | string | | `"children"` | 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. | | `select` | string | | `"id,name,webUrl"` | 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. | | `orderby` | string | | `"name desc"` | 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'. | | `drive_id` | string | | `"b!C378D127A8A967E6!115"` | 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. | | `skip_token` | string | | — | A token to retrieve the next page of results, obtained from the @odata.nextLink in a previous response. | | `search_scope` | string | | — | 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. | | `stripped_annotations` | array | | — | Internal field to track stripped annotations. Not exposed to API. | | `transformed_path_query` | string | | — | Internal field to track if path-based query was transformed. Not exposed to API. | | `transformed_kql_operator` | string | | — | Internal field to track if a KQL operator was transformed. Not exposed to API. | | `transformed_parent_query` | string | | — | Internal field to track if parent: filter was stripped from query. Not exposed to API. | | `transformed_wildcard_query` | string | | — | Internal field to track if wildcard characters were removed from query. Not exposed to API. | *** ### `One Drive Unfollow Item` Integration name: **ONE\_DRIVE\_UNFOLLOW\_ITEM** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"01H3CZALAAAAAAAAAAAAAAAAAAAAAAAAAA"` | The unique identifier of the driveItem to unfollow. This is the ID of an item in the user's followed items collection. | *** ### `One Drive Update Drive Item Metadata` Integration name: **ONE\_DRIVE\_UPDATE\_DRIVE\_ITEM\_METADATA** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | | `"new-file-name.docx"` | The new name for the drive item. Must not contain illegal characters: `\`, `/`, `:`, `*`, `?`, `'`, `<`, `>`, `\|`; these trigger an `invalidRequest` error. | | `item_id` | string | ✅ | `"01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK"` | The unique identifier of the drive item (file or folder) to update. | | `site_id` | string | | `"contoso.sharepoint.com,024d491a-4d09-4194-ae1f-7413535507dc,024d491a-4d09-4194-ae1f-7413535507dc"` | The unique identifier of the site. Used when updating an item within a site's drive. | | `user_id` | string | | `"024d491a-4d09-4194-ae1f-7413535507dc"` | The unique identifier of the user. Used when updating an item within a specific user's drive. | | `drive_id` | string | | `"b!C3NkF4b2GU2msLpLqgZ4oYd_S4P0S6_FhG0bS-WpTkYwGVc_FmBYSZ7d0x_ZJpG-"` | 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}. | | `group_id` | string | | `"024d491a-4d09-4194-ae1f-7413535507dc"` | The unique identifier of the group. Used when updating an item within a group's drive. | | `if_match` | string | | `"\"{99F4367E-7299-4600-A8A0-3F158F4E9D6B},2\""` | 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. | | `description` | string | | `"Updated project proposal document."` | The new description for the drive item. | | `file_system_info` | object | | `{"createdDateTime":"2024-01-15T10:30:00Z","lastModifiedDateTime":"2024-01-15T14:20:00Z"}` | File system information on client. | | `parent_reference_id` | string | | `"01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK"` | 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. | | `parent_reference_drive_id` | string | | `"b!C3NkF4b2GU2msLpLqgZ4oYd_S4P0S6_FhG0bS-WpTkYwGVc_FmBYSZ7d0x_ZJpG-"` | The drive ID of the new parent item, if moving to a different drive. | *** ### `One Drive Update Drive Items Permissions` Integration name: **ONE\_DRIVE\_UPDATE\_DRIVE\_ITEMS\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | `roles` | array | ✅ | `["write"]` | Array of roles to assign to the permission. Valid values: read, write, owner. | | `item_id` | string | ✅ | `"01LLJYZ3F6Y2GOVW7725BZO354PWSELRRZ"` | The unique identifier of the drive item. | | `site_id` | string | | `"contoso.sharepoint.com,2C712604-1397-42ED-85C7-5843590F0202,2D22A158-83D2-4D48-92C1-502810230D0A"` | The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site's drive. | | `user_id` | string | | `"024d426a-2f0f-4e9a-92c1-502810230d0a"` | The unique identifier of a user. Use this if the item is in a specific user's drive (other than 'me'). | | `drive_id` | string | | `"b!C1234567890ABCDEFGH"` | The unique identifier of the drive. Required if not using other identifiers like group\_id, site\_id, or user\_id. | | `group_id` | string | | `"024d426a-2f0f-4e9a-92c1-502810230d0a"` | The unique identifier of a group. Use this if the item is in a group's drive. | | `permission_id` | string | ✅ | `"aTowIy5mfG1lbWJlcnNoaXB8a2FyYW52YWlkeWFAYXV0aGtpdC5haQ"` | The unique identifier of the permission to update. | *** ### `One Drive Update File Content` Integration name: **ONE\_DRIVE\_UPDATE\_FILE\_CONTENT** Tool to create an upload session for updating an existing file's content in OneDrive. Use when you need to overwrite/update an existing DriveItem's content while preserving its item ID, avoiding duplicate copies and maintaining existing share links. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------- | ------- | :------: | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | | `"document.pdf"` | The name of the item (filename and extension). Use this to override the filename during the upload session. | | `item_id` | string | ✅ | `"01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK"` | The unique identifier of the DriveItem (file) to update. | | `site_id` | string | | `"contoso.sharepoint.com,024d491a-4d09-4194-ae1f-7413535507dc,024d491a-4d09-4194-ae1f-7413535507dc"` | The unique identifier of the SharePoint site. If provided, uses /sites/{siteId}/drive. Mutually exclusive with drive\_id, group\_id, and user\_id. | | `user_id` | string | | `"024d491a-4d09-4194-ae1f-7413535507dc"` | The unique identifier of the user. If provided, uses /users/{userId}/drive. Mutually exclusive with drive\_id, site\_id, and group\_id. | | `drive_id` | string | | `"b!C3NkF4b2GU2msLpLqgZ4oYd_S4P0S6_FhG0bS-WpTkYwGVc_FmBYSZ7d0x_ZJpG-"` | The unique identifier of the drive. If not provided, uses /me/drive. Mutually exclusive with site\_id, group\_id, and user\_id. | | `group_id` | string | | `"024d491a-4d09-4194-ae1f-7413535507dc"` | The unique identifier of the group. If provided, uses /groups/{groupId}/drive. Mutually exclusive with drive\_id, site\_id, and user\_id. | | `file_size` | integer | | `1048576` | Provides an expected file size to perform a quota check before uploading. Only supported on OneDrive Personal. | | `description` | string | | `"Project proposal for Q1 2024"` | Provides a user-visible description of the item. Only supported on OneDrive Personal. | | `defer_commit` | boolean | | — | If true, the file creation is deferred until an explicit completion request is made. Useful for very large files where you want to control when the upload is finalized. | | `media_source` | object | | — | Media source information. Only on OneDrive for Business and SharePoint. | | `if_match_etag` | string | | `"aQzlGRDlBMjdBRDQ5RUVCOTE3LjA"` | 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. | | `file_system_info` | object | | — | File system information on client. | | `conflict_behavior` | string | | — | 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. | | `drive_item_source` | object | | — | Information about the drive item source. Only on OneDrive for Business and SharePoint. | | `if_none_match_etag` | string | | `"aQzlGRDlBMjdBRDQ5RUVCOTE3LjA"` | 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. | *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/onedrive.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.