name: one-drive-automation
description: Automate OneDrive file management, search, uploads, downloads, sharing, permissions, and folder operations via Rube MCP (Composio). Always search tools first for current schemas.
OneDrive Automation via Rube MCP
Automate OneDrive operations including file upload/download, search, folder management, sharing links, permissions management, and drive browsing through Composio's OneDrive toolkit.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active OneDrive connection via
RUBE_MANAGE_CONNECTIONS with toolkit one_drive
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit one_drive
- If connection is not ACTIVE, follow the returned auth link to complete Microsoft OAuth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Search and Browse Files
When to use: User wants to find files or browse folder contents in OneDrive
Tool sequence:
ONE_DRIVE_GET_DRIVE - Verify drive access and get drive details [Prerequisite]
ONE_DRIVE_SEARCH_ITEMS - Keyword search across filenames, metadata, and content [Required]
ONE_DRIVE_ONEDRIVE_LIST_ITEMS - List all items in the root of a drive [Optional]
ONE_DRIVE_GET_ITEM - Get detailed metadata for a specific item, expand children [Optional]
ONE_DRIVE_ONEDRIVE_FIND_FILE - Find a specific file by exact name in a folder [Optional]
ONE_DRIVE_ONEDRIVE_FIND_FOLDER - Find a specific folder by name [Optional]
ONE_DRIVE_LIST_DRIVES - List all accessible drives [Optional]
Key parameters:
q: Search query (plain keywords only, NOT KQL syntax)
search_scope: "root" (folder hierarchy) or "drive" (includes shared items)
top: Max items per page (default 200)
skip_token: Pagination token from @odata.nextLink
select: Comma-separated fields to return (e.g., "id,name,webUrl,size")
orderby: Sort order (e.g., "name asc", "name desc")
item_id: Item ID for GET_ITEM
expand_relations: Array like ["children"] or ["thumbnails"] for GET_ITEM
user_id: "me" (default) or specific user ID/email
Pitfalls:
ONE_DRIVE_SEARCH_ITEMS does NOT support KQL operators (folder:, file:, filetype:, path:); these are treated as literal text
- Wildcard characters (
*, ?) are NOT supported and are auto-removed; use file extension keywords instead (e.g., "pdf" not "*.pdf")
ONE_DRIVE_ONEDRIVE_LIST_ITEMS returns only root-level contents; use recursive ONE_DRIVE_GET_ITEM with expand_relations: ["children"] for deeper levels
- Large folders paginate; always follow
skip_token / @odata.nextLink until exhausted
- Some drive ID formats may return "ObjectHandle is Invalid" errors due to Microsoft Graph API limitations
2. Upload and Download Files
When to use: User wants to upload files to OneDrive or download files from it
Tool sequence:
ONE_DRIVE_ONEDRIVE_FIND_FOLDER - Locate the target folder [Prerequisite]
ONE_DRIVE_ONEDRIVE_UPLOAD_FILE - Upload a file to a specified folder [Required for upload]
ONE_DRIVE_DOWNLOAD_FILE - Download a file by item ID [Required for download]
ONE_DRIVE_GET_ITEM - Get file details before download [Optional]
Key parameters:
file: FileUploadable object with s3key, mimetype, and name for uploads
folder: Destination path (e.g., "/Documents/Reports") or folder ID for uploads
item_id: File's unique identifier for downloads
file_name: Desired filename with extension for downloads
drive_id: Specific drive ID (for SharePoint or OneDrive for Business)
user_id: "me" (default) or specific user identifier
Pitfalls:
- Upload automatically renames on conflict (no overwrite option by default)
- Large files are automatically handled via chunking
drive_id overrides user_id when both are provided
- Item IDs vary by platform: OneDrive for Business uses
01... prefix, OneDrive Personal uses HASH!NUMBER format
- Item IDs are case-sensitive; use exactly as returned from API
3. Share Files and Manage Permissions
When to use: User wants to share files/folders or manage who has access
Tool sequence:
ONE_DRIVE_ONEDRIVE_FIND_FILE or ONE_DRIVE_ONEDRIVE_FIND_FOLDER - Locate the item [Prerequisite]
ONE_DRIVE_GET_ITEM_PERMISSIONS - Check current permissions [Prerequisite]
ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM - Grant access to specific users [Required]
ONE_DRIVE_CREATE_LINK - Create a shareable link [Optional]
ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA - Update item metadata [Optional]
Key parameters:
item_id: The file or folder to share
recipients: Array of objects with email or object_id
roles: Array with "read" or "write"
send_invitation: true to send notification email, false for silent permission grant
require_sign_in: true to require authentication to access
message: Custom message for invitation (max 2000 characters)
expiration_date_time: ISO 8601 date for permission expiry
retain_inherited_permissions: true (default) to keep existing inherited permissions
Pitfalls:
- Using wrong
item_id with INVITE_USER_TO_DRIVE_ITEM changes permissions on unintended items; always verify first
- Write or higher roles are impactful; get explicit user confirmation before granting
GET_ITEM_PERMISSIONS returns inherited and owner entries; do not assume response only reflects recent changes
permissions cannot be expanded via ONE_DRIVE_GET_ITEM; use the separate permissions endpoint
- At least one of
require_sign_in or send_invitation must be true
4. Manage Folders (Create, Move, Delete, Copy)
When to use: User wants to create, move, rename, delete, or copy files and folders
Tool sequence:
ONE_DRIVE_ONEDRIVE_FIND_FOLDER - Locate source and destination folders [Prerequisite]
ONE_DRIVE_ONEDRIVE_CREATE_FOLDER - Create a new folder [Required for create]
ONE_DRIVE_MOVE_ITEM - Move a file or folder to a new location [Required for move]
ONE_DRIVE_COPY_ITEM - Copy a file or folder (async operation) [Required for copy]
ONE_DRIVE_DELETE_ITEM - Move item to recycle bin [Required for delete]
ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA - Rename or update item properties [Optional]
Key parameters:
name: Folder name for creation or new name for rename/copy
parent_folder: Path (e.g., "/Documents/Reports") or folder ID for creation
itemId: Item to move
parentReference: Object with id (destination folder ID) for moves: {"id": "folder_id"}
item_id: Item to copy or delete
parent_reference: Object with id and optional driveId for copy destination
@microsoft.graph.conflictBehavior: "fail", "replace", or "rename" for copies
if_match: ETag for optimistic concurrency on deletes
Pitfalls:
ONE_DRIVE_MOVE_ITEM does NOT support cross-drive moves; use ONE_DRIVE_COPY_ITEM for cross-drive transfers
parentReference for moves requires folder ID (not folder name); resolve with ONEDRIVE_FIND_FOLDER first
ONE_DRIVE_COPY_ITEM is asynchronous; response provides a URL to monitor progress
ONE_DRIVE_DELETE_ITEM moves to recycle bin, not permanent deletion
- Folder creation auto-renames on conflict (e.g., "New Folder" becomes "New Folder 1")
- Provide either
name or parent_reference (or both) for ONE_DRIVE_COPY_ITEM
5. Track Changes and Drive Information
When to use: User wants to monitor changes or get drive/quota information
Tool sequence:
ONE_DRIVE_GET_DRIVE - Get drive properties and metadata [Required]
ONE_DRIVE_GET_QUOTA - Check storage quota (total, used, remaining) [Optional]
ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA - Track changes in SharePoint site drives [Optional]
ONE_DRIVE_GET_ITEM_VERSIONS - Get version history of a file [Optional]
Key parameters:
drive_id: Drive identifier (or "me" for personal drive)
site_id: SharePoint site identifier for delta tracking
token: Delta token ("latest" for current state, URL for next page, or timestamp)
item_id: File ID for version history
Pitfalls:
- Delta queries are only available for SharePoint site drives via
ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA
- Token
"latest" returns current delta token without items (useful as starting point)
- Deep or large drives can take several minutes to crawl; use batching and resume logic
Common Patterns
ID Resolution
- User: Use
"me" for authenticated user or specific user email/GUID
- Item ID from find: Use
ONE_DRIVE_ONEDRIVE_FIND_FILE or ONE_DRIVE_ONEDRIVE_FIND_FOLDER to get item IDs
- Item ID from search: Extract from
ONE_DRIVE_SEARCH_ITEMS results
- Drive ID: Use
ONE_DRIVE_LIST_DRIVES or ONE_DRIVE_GET_DRIVE to discover drives
- Folder path to ID: Use
ONE_DRIVE_ONEDRIVE_FIND_FOLDER with path, then extract ID from response
ID formats vary by platform:
- OneDrive for Business/SharePoint:
01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK
- OneDrive Personal:
D4648F06C91D9D3D!54927
Pagination
OneDrive uses token-based pagination:
- Follow
@odata.nextLink or skip_token until no more pages
- Set
top for page size (varies by endpoint)
ONE_DRIVE_ONEDRIVE_LIST_ITEMS auto-handles pagination internally
- Aggressive parallel requests can trigger HTTP 429; honor
Retry-After headers
Path vs ID
Most OneDrive tools accept either paths or IDs:
- Paths: Start with
/ (e.g., "/Documents/Reports")
- IDs: Use unique item identifiers from API responses
- Item paths for permissions: Use
:/path/to/item:/ format
Known Pitfalls
ID Formats
- Item IDs are case-sensitive and platform-specific
- Never use web URLs, sharing links, or manually constructed identifiers as item IDs
- Always use IDs exactly as returned from Microsoft Graph API
Rate Limits
- Aggressive parallel
ONE_DRIVE_GET_ITEM calls can trigger HTTP 429 Too Many Requests
- Honor
Retry-After headers and implement throttling
- Deep drive crawls should use batching with delays
Search Limitations
- No KQL support; use plain keywords only
- No wildcard characters; use extension keywords (e.g.,
"pdf" not "*.pdf")
- No path-based filtering in search; use folder listing instead
q='*' wildcard-only queries return HTTP 400 invalidRequest
Parameter Quirks
drive_id overrides user_id when both are provided
permissions cannot be expanded via GET_ITEM; use dedicated permissions endpoint
- Move operations require folder IDs in
parentReference, not folder names
- Copy operations are asynchronous; response provides monitoring URL
Quick Reference
| Task |
Tool Slug |
Key Params |
| Search files |
ONE_DRIVE_SEARCH_ITEMS |
q, search_scope, top |
| List root items |
ONE_DRIVE_ONEDRIVE_LIST_ITEMS |
user_id, select, top |
| Get item details |
ONE_DRIVE_GET_ITEM |
item_id, expand_relations |
| Find file by name |
ONE_DRIVE_ONEDRIVE_FIND_FILE |
name, folder |
| Find folder by name |
ONE_DRIVE_ONEDRIVE_FIND_FOLDER |
name, folder |
| Upload file |
ONE_DRIVE_ONEDRIVE_UPLOAD_FILE |
file, folder |
| Download file |
ONE_DRIVE_DOWNLOAD_FILE |
item_id, file_name |
| Create folder |
ONE_DRIVE_ONEDRIVE_CREATE_FOLDER |
name, parent_folder |
| Move item |
ONE_DRIVE_MOVE_ITEM |
itemId, parentReference |
| Copy item |
ONE_DRIVE_COPY_ITEM |
item_id, parent_reference, name |
| Delete item |
ONE_DRIVE_DELETE_ITEM |
item_id |
| Share with users |
ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM |
item_id, recipients, roles |
| Create share link |
ONE_DRIVE_CREATE_LINK |
item_id, link type |
| Get permissions |
ONE_DRIVE_GET_ITEM_PERMISSIONS |
item_id |
| Update metadata |
ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA |
item_id, fields |
| Get drive info |
ONE_DRIVE_GET_DRIVE |
drive_id |
| List drives |
ONE_DRIVE_LIST_DRIVES |
user/group/site scope |
| Get quota |
ONE_DRIVE_GET_QUOTA |
(none) |
| Track changes |
ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA |
site_id, token |
| Version history |
ONE_DRIVE_GET_ITEM_VERSIONS |
item_id |
1---2name: one-drive-automation-33description: <!-- AUTO-GENERATED by export-skills.py — DO NOT EDIT -->4---5<!-- AUTO-GENERATED by export-skills.py — DO NOT EDIT -->6---7name: one-drive-automation8description: Automate OneDrive file management, search, uploads, downloads, sharing, permissions, and folder operations via Rube MCP (Composio). Always search tools first for current schemas.9---1011# OneDrive Automation via Rube MCP1213Automate OneDrive operations including file upload/download, search, folder management, sharing links, permissions management, and drive browsing through Composio's OneDrive toolkit.1415## Prerequisites1617- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)18- Active OneDrive connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `one_drive`19- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas2021## Setup2223**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.2425261. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds272. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `one_drive`283. If connection is not ACTIVE, follow the returned auth link to complete Microsoft OAuth294. Confirm connection status shows ACTIVE before running any workflows3031## Core Workflows3233### 1. Search and Browse Files3435**When to use**: User wants to find files or browse folder contents in OneDrive3637**Tool sequence**:381. `ONE_DRIVE_GET_DRIVE` - Verify drive access and get drive details [Prerequisite]392. `ONE_DRIVE_SEARCH_ITEMS` - Keyword search across filenames, metadata, and content [Required]403. `ONE_DRIVE_ONEDRIVE_LIST_ITEMS` - List all items in the root of a drive [Optional]414. `ONE_DRIVE_GET_ITEM` - Get detailed metadata for a specific item, expand children [Optional]425. `ONE_DRIVE_ONEDRIVE_FIND_FILE` - Find a specific file by exact name in a folder [Optional]436. `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` - Find a specific folder by name [Optional]447. `ONE_DRIVE_LIST_DRIVES` - List all accessible drives [Optional]4546**Key parameters**:47- `q`: Search query (plain keywords only, NOT KQL syntax)48- `search_scope`: `"root"` (folder hierarchy) or `"drive"` (includes shared items)49- `top`: Max items per page (default 200)50- `skip_token`: Pagination token from `@odata.nextLink`51- `select`: Comma-separated fields to return (e.g., `"id,name,webUrl,size"`)52- `orderby`: Sort order (e.g., `"name asc"`, `"name desc"`)53- `item_id`: Item ID for `GET_ITEM`54- `expand_relations`: Array like `["children"]` or `["thumbnails"]` for `GET_ITEM`55- `user_id`: `"me"` (default) or specific user ID/email5657**Pitfalls**:58- `ONE_DRIVE_SEARCH_ITEMS` does NOT support KQL operators (`folder:`, `file:`, `filetype:`, `path:`); these are treated as literal text59- Wildcard characters (`*`, `?`) are NOT supported and are auto-removed; use file extension keywords instead (e.g., `"pdf"` not `"*.pdf"`)60- `ONE_DRIVE_ONEDRIVE_LIST_ITEMS` returns only root-level contents; use recursive `ONE_DRIVE_GET_ITEM` with `expand_relations: ["children"]` for deeper levels61- Large folders paginate; always follow `skip_token` / `@odata.nextLink` until exhausted62- Some drive ID formats may return "ObjectHandle is Invalid" errors due to Microsoft Graph API limitations6364### 2. Upload and Download Files6566**When to use**: User wants to upload files to OneDrive or download files from it6768**Tool sequence**:691. `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` - Locate the target folder [Prerequisite]702. `ONE_DRIVE_ONEDRIVE_UPLOAD_FILE` - Upload a file to a specified folder [Required for upload]713. `ONE_DRIVE_DOWNLOAD_FILE` - Download a file by item ID [Required for download]724. `ONE_DRIVE_GET_ITEM` - Get file details before download [Optional]7374**Key parameters**:75- `file`: FileUploadable object with `s3key`, `mimetype`, and `name` for uploads76- `folder`: Destination path (e.g., `"/Documents/Reports"`) or folder ID for uploads77- `item_id`: File's unique identifier for downloads78- `file_name`: Desired filename with extension for downloads79- `drive_id`: Specific drive ID (for SharePoint or OneDrive for Business)80- `user_id`: `"me"` (default) or specific user identifier8182**Pitfalls**:83- Upload automatically renames on conflict (no overwrite option by default)84- Large files are automatically handled via chunking85- `drive_id` overrides `user_id` when both are provided86- Item IDs vary by platform: OneDrive for Business uses `01...` prefix, OneDrive Personal uses `HASH!NUMBER` format87- Item IDs are case-sensitive; use exactly as returned from API8889### 3. Share Files and Manage Permissions9091**When to use**: User wants to share files/folders or manage who has access9293**Tool sequence**:941. `ONE_DRIVE_ONEDRIVE_FIND_FILE` or `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` - Locate the item [Prerequisite]952. `ONE_DRIVE_GET_ITEM_PERMISSIONS` - Check current permissions [Prerequisite]963. `ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM` - Grant access to specific users [Required]974. `ONE_DRIVE_CREATE_LINK` - Create a shareable link [Optional]985. `ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA` - Update item metadata [Optional]99100**Key parameters**:101- `item_id`: The file or folder to share102- `recipients`: Array of objects with `email` or `object_id`103- `roles`: Array with `"read"` or `"write"`104- `send_invitation`: `true` to send notification email, `false` for silent permission grant105- `require_sign_in`: `true` to require authentication to access106- `message`: Custom message for invitation (max 2000 characters)107- `expiration_date_time`: ISO 8601 date for permission expiry108- `retain_inherited_permissions`: `true` (default) to keep existing inherited permissions109110**Pitfalls**:111- Using wrong `item_id` with `INVITE_USER_TO_DRIVE_ITEM` changes permissions on unintended items; always verify first112- Write or higher roles are impactful; get explicit user confirmation before granting113- `GET_ITEM_PERMISSIONS` returns inherited and owner entries; do not assume response only reflects recent changes114- `permissions` cannot be expanded via `ONE_DRIVE_GET_ITEM`; use the separate permissions endpoint115- At least one of `require_sign_in` or `send_invitation` must be `true`116117### 4. Manage Folders (Create, Move, Delete, Copy)118119**When to use**: User wants to create, move, rename, delete, or copy files and folders120121**Tool sequence**:1221. `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` - Locate source and destination folders [Prerequisite]1232. `ONE_DRIVE_ONEDRIVE_CREATE_FOLDER` - Create a new folder [Required for create]1243. `ONE_DRIVE_MOVE_ITEM` - Move a file or folder to a new location [Required for move]1254. `ONE_DRIVE_COPY_ITEM` - Copy a file or folder (async operation) [Required for copy]1265. `ONE_DRIVE_DELETE_ITEM` - Move item to recycle bin [Required for delete]1276. `ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA` - Rename or update item properties [Optional]128129**Key parameters**:130- `name`: Folder name for creation or new name for rename/copy131- `parent_folder`: Path (e.g., `"/Documents/Reports"`) or folder ID for creation132- `itemId`: Item to move133- `parentReference`: Object with `id` (destination folder ID) for moves: `{"id": "folder_id"}`134- `item_id`: Item to copy or delete135- `parent_reference`: Object with `id` and optional `driveId` for copy destination136- `@microsoft.graph.conflictBehavior`: `"fail"`, `"replace"`, or `"rename"` for copies137- `if_match`: ETag for optimistic concurrency on deletes138139**Pitfalls**:140- `ONE_DRIVE_MOVE_ITEM` does NOT support cross-drive moves; use `ONE_DRIVE_COPY_ITEM` for cross-drive transfers141- `parentReference` for moves requires folder ID (not folder name); resolve with `ONEDRIVE_FIND_FOLDER` first142- `ONE_DRIVE_COPY_ITEM` is asynchronous; response provides a URL to monitor progress143- `ONE_DRIVE_DELETE_ITEM` moves to recycle bin, not permanent deletion144- Folder creation auto-renames on conflict (e.g., "New Folder" becomes "New Folder 1")145- Provide either `name` or `parent_reference` (or both) for `ONE_DRIVE_COPY_ITEM`146147### 5. Track Changes and Drive Information148149**When to use**: User wants to monitor changes or get drive/quota information150151**Tool sequence**:1521. `ONE_DRIVE_GET_DRIVE` - Get drive properties and metadata [Required]1532. `ONE_DRIVE_GET_QUOTA` - Check storage quota (total, used, remaining) [Optional]1543. `ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA` - Track changes in SharePoint site drives [Optional]1554. `ONE_DRIVE_GET_ITEM_VERSIONS` - Get version history of a file [Optional]156157**Key parameters**:158- `drive_id`: Drive identifier (or `"me"` for personal drive)159- `site_id`: SharePoint site identifier for delta tracking160- `token`: Delta token (`"latest"` for current state, URL for next page, or timestamp)161- `item_id`: File ID for version history162163**Pitfalls**:164- Delta queries are only available for SharePoint site drives via `ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA`165- Token `"latest"` returns current delta token without items (useful as starting point)166- Deep or large drives can take several minutes to crawl; use batching and resume logic167168## Common Patterns169170### ID Resolution171- **User**: Use `"me"` for authenticated user or specific user email/GUID172- **Item ID from find**: Use `ONE_DRIVE_ONEDRIVE_FIND_FILE` or `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` to get item IDs173- **Item ID from search**: Extract from `ONE_DRIVE_SEARCH_ITEMS` results174- **Drive ID**: Use `ONE_DRIVE_LIST_DRIVES` or `ONE_DRIVE_GET_DRIVE` to discover drives175- **Folder path to ID**: Use `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` with path, then extract ID from response176177ID formats vary by platform:178- OneDrive for Business/SharePoint: `01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK`179- OneDrive Personal: `D4648F06C91D9D3D!54927`180181### Pagination182OneDrive uses token-based pagination:183- Follow `@odata.nextLink` or `skip_token` until no more pages184- Set `top` for page size (varies by endpoint)185- `ONE_DRIVE_ONEDRIVE_LIST_ITEMS` auto-handles pagination internally186- Aggressive parallel requests can trigger HTTP 429; honor `Retry-After` headers187188### Path vs ID189Most OneDrive tools accept either paths or IDs:190- **Paths**: Start with `/` (e.g., `"/Documents/Reports"`)191- **IDs**: Use unique item identifiers from API responses192- **Item paths for permissions**: Use `:/path/to/item:/` format193194## Known Pitfalls195196### ID Formats197- Item IDs are case-sensitive and platform-specific198- Never use web URLs, sharing links, or manually constructed identifiers as item IDs199- Always use IDs exactly as returned from Microsoft Graph API200201### Rate Limits202- Aggressive parallel `ONE_DRIVE_GET_ITEM` calls can trigger HTTP 429 Too Many Requests203- Honor `Retry-After` headers and implement throttling204- Deep drive crawls should use batching with delays205206### Search Limitations207- No KQL support; use plain keywords only208- No wildcard characters; use extension keywords (e.g., `"pdf"` not `"*.pdf"`)209- No path-based filtering in search; use folder listing instead210- `q='*'` wildcard-only queries return HTTP 400 invalidRequest211212### Parameter Quirks213- `drive_id` overrides `user_id` when both are provided214- `permissions` cannot be expanded via `GET_ITEM`; use dedicated permissions endpoint215- Move operations require folder IDs in `parentReference`, not folder names216- Copy operations are asynchronous; response provides monitoring URL217218## Quick Reference219220| Task | Tool Slug | Key Params |221|------|-----------|------------|222| Search files | `ONE_DRIVE_SEARCH_ITEMS` | `q`, `search_scope`, `top` |223| List root items | `ONE_DRIVE_ONEDRIVE_LIST_ITEMS` | `user_id`, `select`, `top` |224| Get item details | `ONE_DRIVE_GET_ITEM` | `item_id`, `expand_relations` |225| Find file by name | `ONE_DRIVE_ONEDRIVE_FIND_FILE` | `name`, `folder` |226| Find folder by name | `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` | `name`, `folder` |227| Upload file | `ONE_DRIVE_ONEDRIVE_UPLOAD_FILE` | `file`, `folder` |228| Download file | `ONE_DRIVE_DOWNLOAD_FILE` | `item_id`, `file_name` |229| Create folder | `ONE_DRIVE_ONEDRIVE_CREATE_FOLDER` | `name`, `parent_folder` |230| Move item | `ONE_DRIVE_MOVE_ITEM` | `itemId`, `parentReference` |231| Copy item | `ONE_DRIVE_COPY_ITEM` | `item_id`, `parent_reference`, `name` |232| Delete item | `ONE_DRIVE_DELETE_ITEM` | `item_id` |233| Share with users | `ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM` | `item_id`, `recipients`, `roles` |234| Create share link | `ONE_DRIVE_CREATE_LINK` | `item_id`, link type |235| Get permissions | `ONE_DRIVE_GET_ITEM_PERMISSIONS` | `item_id` |236| Update metadata | `ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA` | `item_id`, fields |237| Get drive info | `ONE_DRIVE_GET_DRIVE` | `drive_id` |238| List drives | `ONE_DRIVE_LIST_DRIVES` | user/group/site scope |239| Get quota | `ONE_DRIVE_GET_QUOTA` | (none) |240| Track changes | `ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA` | `site_id`, `token` |241| Version history | `ONE_DRIVE_GET_ITEM_VERSIONS` | `item_id` |242243<!-- Source: .faos/custom/skills/devops/one-drive-automation/SKILL.md -->