List Library Folder
sharepoint.list_drive_children
ActionFiles & storageconnection required
Calls the SharePoint API with the connection's credentials.
List the files and folders in the site's default document library, from the library root when no folder is named.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- SharePoint
- Secret shape
- {"client_id": "…", "client_secret": "…", "refresh_token": "…"} with the Sites.ReadWrite.All delegated scope
- Config it needs
- tenant, site_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
4 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
site_id The site id that holds the list, as 'hostname,siteCollectionId,siteId'. Use sharepoint.get_site or sharepoint.search_sites to find it. | string | Yes | — | — | — |
item_id Id of the folder to list. Takes precedence over item_path. | string | No | — | — | — |
item_path Library-relative folder path to list, e.g. 'Shared Documents/2026'. | string | No | — | — | — |
max_results How many children to return at most; Graph pages are followed until this many. | number | No | 50 | 1–1000 | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"max_results": 50
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
items The driveItems returned. | array | — |
count How many items were returned. | number | — |
{
"count": 0,
"items": []
}See List Library Folder run in a workflow.
In a technical demo we add the SharePoint connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.