> ## 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.

# List Folder Contents

> List files and sub-folders in a OneDrive folder. Use folder_id='root' to start at the drive root.

`onedrive_list_items`

Lists files and sub-folders in a OneDrive folder. Pass `folder_id="root"` to start at the top of the drive, then drill into sub-folders by passing their `id` as `folder_id`. Use `onedrive_get_file_content` to download the content of a listed file.

## Parameters

| Parameter         | Type   | Required | Description                                                           |
| ----------------- | ------ | -------- | --------------------------------------------------------------------- |
| `folder_id`       | string | No       | Item ID of the folder to list. Defaults to `"root"` (the drive root). |
| `limit`           | number | No       | Max items to return (1–100, default 20).                              |
| `offset`          | number | No       | Items to skip for pagination (default 0).                             |
| `response_format` | string | No       | Output format: `"markdown"` (default) or `"json"`.                    |

## Returns

An object with an `items` array, `folder_id`, `total_count`, `count`, `offset`, `has_more`, and `next_offset`. Each item includes `id`, `name`, `webUrl`, `size`, `createdDateTime`, `lastModifiedDateTime`, `file.mimeType` (for files), `folder.childCount` (for folders), and `parentReference.path`.

## Example use

> "Show me what's in the root of my OneDrive."

> "List the contents of folder ID `01ABC123`."