List Children

List files and folders in a parent folder. Returns paginated results.

Parameters

Parameter	Type	Required	Description
`folder_id`	`string`	Optional	Parent folder ID or alias ("home", "favorites", "allshared"). Defaults to "home".
`top`	`number`	Optional	Maximum number of items to return (pagination). Default 100.
`skip`	`number`	Optional	Number of items to skip (pagination). Default 0.
`include_deleted`	`boolean`	Optional	Include deleted items (default false)
`filter`	`string`	Optional	OData filter expression (e.g., "Name eq 'myfile.txt'")
`orderby`	`string`	Optional	OData orderby expression (e.g., "Name asc", "CreationDate desc")

Examples

MCP Tool Call

{
  "name": "sharefile_listChildren",
  "arguments": {
    "folder_id": "example",
    "top": 12345,
    "skip": 12345,
    "include_deleted": true,
    "filter": "example",
    "orderby": "example",
    "summary_only": true
  }
}

REST API

curl -X POST https://api.syncello.io/v1/tools/sharefile/listChildren \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "folder_id": "example",
  "top": 12345,
  "skip": 12345,
  "include_deleted": true,
  "filter": "example",
  "orderby": "example",
  "summary_only": true
}'