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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.