List Folder

nextcloud.list_folder

ActionFiles & storageconnection required

Calls the Nextcloud API with the connection's credentials.

List the direct contents of a folder in the account's Nextcloud files. The folder's own properties are returned separately as 'folder'.

Ask about Nextcloud All Nextcloud nodes Provider API docs ↗

Connection

Required: Yes — the node will not save without one
Auth type: Username & password
Providers: Nextcloud
Secret shape: {"username": "…", "password": "<app password>"}
Config it needs: base_url
Resolved by: config.connection_id, else node.connection_id

Configuration

1 field, none 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
path Folder to list, e.g. /Documents. Leave blank for the account's files root.	string	No	/	—	—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "path": "/"
}

Output

One shape.

result

Field	Type	Example
path The folder that was listed.	string	/Documents
folder The folder's own WebDAV properties.	object	—
items[].name The file or folder name.	string	report.pdf
items[].path Path relative to the account's files root.	string	/Documents/report.pdf
items[].href The WebDAV href Nextcloud returned for the entry.	string	—
items[].is_folder True when the entry is a folder (a WebDAV collection).	boolean	—
items[].size Size in bytes; for a folder, the total Nextcloud reports.	number	—
items[].content_type The MIME type; empty for a folder.	string	application/pdf
items[].last_modified When the entry last changed, as Nextcloud wrote it.	string	—
items[].etag The entry's ETag, with its quotes stripped.	string	—
items[].file_id The numeric Nextcloud file id (oc:fileid).	string	12345
items[].unique_id The globally unique file id (oc:id).	string	—
items[].permissions Nextcloud's permission letters for this account, e.g. 'RGDNVCK'.	string	—
count How many entries the folder contains.	number	—

{
  "count": 0,
  "folder": {},
  "items": [
    {
      "content_type": "application/pdf",
      "etag": "",
      "file_id": "12345",
      "href": "",
      "is_folder": false,
      "last_modified": "",
      "name": "report.pdf",
      "path": "/Documents/report.pdf",
      "permissions": "",
      "size": 0,
      "unique_id": ""
    }
  ],
  "path": "/Documents"
}

Related Nextcloud nodes

See List Folder run in a workflow.

In a technical demo we add the Nextcloud connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales