In this guide

Download File

Bring a file from the server back to Shortcuts.

Action referenceRead

What this action does #

First, connect SSH in Services. Then open Actions → + → SSH and choose Download File.

More about this action

Reads the file over SFTP and hands it to Shortcuts as the result's File. A text file of up to 1 MB is also given as Text, so it can be read without a file action.

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.

Path

RequiredText

The file's full path. ~/ means the home folder.

Example value (replace with your own):
~/notes.txt

What comes back #

This action brings a file back. Shortcuts receives it as the result’s File, whatever you choose below. Shortcuts shows the result as text by default, which for a file is only its name and size: tap the Execute Action result where you use it and choose File.

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 file's path on the server.
namestringThe file's name, which the File output also uses.
sizeintegerIn bytes.
textstringThe file's contents, for a text file up to 1 MB.

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 get, over a signed-in SSH session. No web request is made.

Action identifier: ssh.file.download.v1

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

InputKey
Pathpath

SSH setup reference