---
title: "List a OneDrive or SharePoint folder"
method: GET
path: "/v1/capabilities/microsoft-365/drive-children"
tags: ["Capability Sources"]
---

# List a OneDrive or SharePoint folder

`GET /v1/capabilities/microsoft-365/drive-children`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/capabilities/microsoft-365/drive-children`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Lists the items in a folder, or the top of a drive when folderId is omitted: the member's own OneDrive by default, or a SharePoint library or other drive with driveId. Read-only.

## Query parameters

- `driveId` string
- `folderId` string
- `maxResults` integer
- `pageToken` string

## Response `200`

Folder items.

- Microsoft365DriveChildrenResponse
  - `ok` true, required
  - `files` Microsoft365DriveItem[], required
    - `id` string, required
    - `driveId` string, required: Pass with id to read, list or save this item. Empty when Microsoft did not say; resolve webUrl with the link capability then.
    - `parentId` string, required
    - `siteId` string, required: SharePoint site holding the item, when Microsoft reports one.
    - `name` string, required
    - `size` number, nullable, required
    - `modifiedTime` string, required
    - `webUrl` string, required
    - `mimeType` string, required
    - `kind` 'file' | 'folder' | 'unknown', required
    - `eTag` string, required
  - `nextPageToken` string, nullable, required

## Other responses

- `400`: Invalid request, a folder, or an item without content.
- `401`: Sign in first.
- `403`: Organization policy blocks the selected connection.
- `409`: Connect Microsoft 365 with the needed permission, or the file changed since baseRevision (drive_conflict).
- `502`: Microsoft refused or did not return the file; the message gives Microsoft's reason.

## Changes

- **2026-10-23** `c93387179b31`: 4 breaking, 5 info
  - the response property `anyOf[subschema #2]/currentRevision` became nullable for the status `409`
  - the response property `anyOf[subschema #2]/modifiedTime` became nullable for the status `409`
  - the response property `files/items/size` became nullable for the status `200`
  - the response property `nextPageToken` became nullable for the status `200`
  - …5 more
- **2026-10-23** `3e38eb291e52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/capabilities/microsoft-365/drive-children/get.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) - [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/8170cf4a92ca?raw)