Skip to content

List files (storage)

Module · Stable

List files/folders on a connected storage server.

Lists the files and folders in a directory on a connected storage server (Settings → Integrations → Files & Storage). The documents stay where they are — this only reads the listing. path is relative to the connection’s base directory (blank = base). Set pattern to a glob like *.pdf to filter by name, and recursive=true to descend into subfolders. Returns files as a list of {name, path, size, modified, is_dir}; each path feeds straight into Read file (storage). connection only needs filling in when more than one connection of this storage type exists — leave it blank if there’s just one.

Use to discover what is waiting in a shared folder — an SFTP drop directory a supplier writes invoices into, a WebDAV/SharePoint folder, an S3 prefix. Typically the first step of a backfill or an inbox-polling flow: list the folder, then Read file on each result to pull it into memory.

To fetch a file’s contents use Read file (storage). To call a generic HTTP API use HTTP Fetch. If no storage server is connected this step is not offered.

Configured per use: provider, connection, path, pattern, recursive.

  • files
  • count
  • ok
  • error

the storage integration


Auto-generated from the skill registry (load_skills()). Do not edit by hand.