List files
Files and folders inside one folder, with size, type and last change.
GET https://cotlet.dev/api/v1/nextcloud/files
read
Lists the direct contents of one folder of your Nextcloud, folders first. Each item has its path, size, MIME type and last modified time. Use the paths it returns in the other tools. Pass the root path to see the top level of your files.
Parameters
| Name | Type | Description |
|---|---|---|
| path string required | string | Folder path, e.g. '/Clients/Acme'. Use '/' for the top level. |
Request
curl "https://cotlet.dev/api/v1/nextcloud/files?path=%2FClients%2FAcme" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("nextcloud", "list_files", {"path":"/Clients/Acme"})const result = await cotlet.call('nextcloud', 'list_files', {"path":"/Clients/Acme"});cotlet call nextcloud list_files --data '{"path":"/Clients/Acme"}'Example response
{
"items": [
{
"path": "/Clients/Acme/proposal-q3.pdf",
"type": "file",
"size": 388102,
"mime": "application/pdf",
"modified_at": "2026-09-18T14:20:00Z"
},
{
"path": "/Clients/Acme/Contracts",
"type": "folder",
"size": 1204411,
"mime": "httpd/unix-directory",
"modified_at": "2026-10-02T09:05:00Z"
}
]
}