SFTP List Files

List files and directories on an SFTP server. Returns metadata for each entry including name, size, modification date, and permissions.

Requires an SFTP connection.

Configuration

Field	Description	Notes
SFTP Connection	The SFTP connection to use	Required. Select from your configured SFTP connections.
Directory	The remote directory to list	Supports templates. A directory browser is provided. Defaults to the connection's root directory.
File Pattern	A glob pattern to filter results by filename	Supports templates. Examples: *.csv, report_*, data-202?-*. Only applies to files, not directories.
Include Directories	Whether to include directories in the results	Disabled by default.
Recursive Listing	List files in subdirectories as well	Disabled by default. When enabled, traverses up to 50 levels deep.

Input

The node accepts an optional directory input. If the Directory field is left empty, the node will try to use a directory path from upstream data.

Output

The node outputs an object with the following fields:

Field	Description
files	Array of file/directory entries (see below)
total_count	Total number of entries returned
directory	The directory that was listed

Each entry in the files array contains:

Field	Example	Description
name	report.csv	File or directory name
path	uploads/report.csv	Full path relative to the connection root
size	24576	File size in bytes
modified	2026-03-16T10:30:00Z	Last modified timestamp (UTC, ISO 8601)
is_dir	false	Whether the entry is a directory
permissions	-rw-r--r--	Unix-style permission string

TIP

Combine SFTP List Files with an SFTP Stream Read node to process all files matching a pattern. The list output provides the path field that can be passed directly to the reader.

INFO

The File Pattern field uses standard glob syntax. Use * to match any sequence of characters and ? to match a single character. For example, data_*.csv matches data_2026.csv and data_march.csv.