Search files
Search your files by name, type, size or last change inside one folder.
GET https://cotlet.dev/api/v1/nextcloud/files/search
read
Runs a Nextcloud search inside one folder and everything below it, files only. Nextcloud searches within the folder you give, so for the whole account pass the root. Filters combine: a name part, a type such as text/% or application/pdf, a minimum size, a modified date. Results come newest first.
Parameters
| Name | Type | Description |
|---|---|---|
| folder string | string | Folder to search in. Default: '/' (all your files). |
| name_contains string | string | Part of the file name. |
| mime_type string | string | MIME type or pattern, e.g. 'application/pdf' or 'image/%'. |
| min_size_bytes integer | integer | Only files larger than this. |
| modified_since datetime | datetime | Only files changed after this time. |
| limit integer | integer | Maximum results. Default: 50. |
Request
curl https://cotlet.dev/api/v1/nextcloud/files/search \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("nextcloud", "search_files")const result = await cotlet.call('nextcloud', 'search_files');cotlet call nextcloud search_filesExample response
{
"items": [
{
"path": "/Clients/Acme/proposal-q3.pdf",
"size": 388102,
"mime": "application/pdf",
"modified_at": "2026-09-18T14:20:00Z",
"file_id": 48213
}
]
}