Copy File (SFTP)
The Copy File (SFTP) node uploads one or more incoming files to a remote directory over SFTP using a configured SSH service.
Overview
Use this node when files must be transferred over an encrypted SSH channel. The selected SSH service supplies the connection settings and root folder. The node appends the configured path to that service root folder.
Purpose
- Upload
NodeFileoutputs to an SFTP server. - Create missing remote subdirectories below the SSH service root folder.
- Return copied-file metadata for later workflow steps.
Configuration
| Field | Required | Description |
|---|---|---|
| SSH Service | Yes | Connection to the SFTP server. The service stores host, port, credentials, and root folder. See SSH Service. |
| Path | Yes | Remote path below the service root folder. Maximum length is 256 characters. |
Inputs
| Input | Data Type | Input Type | Description |
|---|---|---|---|
| NodeFile | NodeFile | Multiple | One or more files to upload. |
Outputs
| Output | Data Type | Collection | Description |
|---|---|---|---|
| Output | DataObject | False | JSON metadata describing the upload. |
Properties
| Property | FlowDataType | Description |
|---|---|---|
| SFTP_COPY_FILE_COPIED_FILES_INFO | JsonNode | The Copied files info |
Processing Logic
- Opens an SFTP channel through the selected SSH service.
- Builds the remote destination as
service root folder + Path. - Creates missing path segments that look like directories.
- Uploads each input file using the file's computed name.
- Closes the SFTP channel after processing.
- Fails the node if connection, directory creation, or upload fails.
Examples
Upload files to a monthly folder below the SSH service root:
/uploads/2026/06/
If the SSH service root folder is /home/b2win, the files are uploaded under /home/b2win/uploads/2026/06/.
Notes / Limitations
- The Path field is a plain input field in this node; it is passed to the SFTP handler without expression evaluation.
- Missing remote directories are created automatically when the SSH user has permission.
- Existing remote files with the same computed name are overwritten by the SFTP
putoperation. - Use Copy File (FTP) only when plain FTP or FTPS is required.