In this guide

List Folder

The files and folders inside a folder on the server.

Action referenceRead

What this action does #

First, connect SSH in Services. Then open Actions → + → SSH and choose List Folder.

More about this action

Folders come first, then files, each by name. Empty lists the home folder.

Inputs to fill in #

Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.

Folder

OptionalText

The folder's path. Empty or ~ is the home folder.

Example value (replace with your own):
~/Documents

What comes back #

In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.

Returned fieldTypeMeaning
pathstringThe folder's full path.
itemsarrayA list of values.
items[].namestringThe file or folder's name.
items[].pathstringIts full path, ready for Download File or another List Folder.
items[].isFolderbooleanTrue for a folder.
items[].sizeintegerIn bytes.
items[].modifiedstringWhen it last changed, in ISO 8601.

Run it from Shortcuts #

  1. Give the action a recognizable name and tap Save.
  2. In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
  3. Supply any Param or File slots you bound in the inputs, then run the shortcut.

If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.

Advanced reference #

Request, permissions, and identifiers

On the computer: sftp ls, over a signed-in SSH session. No web request is made.

Action identifier: ssh.folder.list.v1

No additional per-action permissions are declared in the app’s catalog. The integration’s connection and account access rules still apply.

InputKey
Folderpath

SSH setup reference