List a folder
nas_file_listLists entries in a NAS folder, defaulting to the logged-in user's personal folder, so you can browse shared-directory contents and optionally recurse into subfolders.
Instructions
List the entries of a folder on the NAS. Omit path to list the personal folder of the logged-in user. Volume roots such as /volume1 are not accessible; start from a shared folder (see nas_file_roots). Entries are in items[0].entries[]; size and the time fields are strings holding 64-bit integers, and the mode field is unreliable, so do not use it to judge permissions. Recursive listing of a large folder can take a minute or more: prefer a deeper path, or nas_search_files when looking for a file by name.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "nas_file_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Folder to list. Absolute NAS path, for example /volume1/docs/report.pdf. | |
| limit | No | Maximum number of entries; 0 means no limit. | |
| recursive | No | Also list all subfolders. Slow on large folders. | |
| timeout_seconds | No | Time limit in seconds (default 120, max 1800). Raise it for large folders or files; a result cut off by the limit is incomplete. |