> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.deepmask.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Files

`onedrive_search_files`

Searches across the user's OneDrive files and folders by name or content. Returns item IDs, names, paths, sizes, and modified dates. Pass the returned `itemId` to `onedrive_get_file_content` to download a file or to `onedrive_get_item` for full metadata.

## Parameters

| Parameter         | Type   | Required | Description                                                                            |
| ----------------- | ------ | -------- | -------------------------------------------------------------------------------------- |
| `query`           | string | Yes      | Search query matching file names and content — e.g. `"budget 2024"`, `"project plan"`. |
| `limit`           | number | No       | Max results to return (1–100, default 20).                                             |
| `offset`          | number | No       | Results to skip for pagination (default 0).                                            |
| `response_format` | string | No       | Output format: `"markdown"` (default) or `"json"`.                                     |

## Returns

An object with a `results` array, `count`, `offset`, `has_more`, and `next_offset`. Each result includes `itemId`, `name`, `webUrl`, `mimeType`, `size`, `lastModifiedDateTime`, `parentPath`, and `isFolder`.

## Example use

> "Search my OneDrive for any files related to the Q3 report."