The /sftp/store Robot

Transloadit is happy to export to whatever storage solution suits you best.

The /sftp/store Robot exports encoding results to your own SFTP server.


Name Type Default Description
user (required) String The username for the SFTP connection.
host (required) String The host with which to establish the SFTP connection.
path String "${unique_prefix}/${file.url_name}" The path at which the file is to be stored. This may include any available Assembly variables.
url_template String "http://host/path" The URL of the file in the result JSON. This may include any of the following supported Assembly variables.
ssl_url_template String "https://{HOST}/{PATH}" The SSL URL of the file in the result JSON. The following Assembly variables are supported.
port Integer 22 The port to be used for the SFTP connection.
file_chmod String Auto This optional parameter controls how an uploaded file's permission bits are set. You can use any string format that the chmod command would accept, such as "755". If you don't specify this option, the file's permission bits aren't changed at all, meaning it's up to your server's configuration (e.g. umask).

Live demos

Our /sftp/store Robot can be used in combination with other Robots, to create powerful workflows unique to your use case.
Here are a few example scenarios, and the required the Assembly Instructions to implement them.
You can also try demos of these examples right here, live on our website.

Apply a watermark to an image and store everything over SFTP

  "steps": {
    "resized": {
      "use": [":original"],
      "robot": "/image/resize",
      "result": true,
      "height": 500,
      "imagemagick_stack": "v1.0.0",
      "resize_strategy": "fit",
      "width": 500,
      "zoom": false
    "watermarked": {
      "use": ["resized"],
      "robot": "/image/resize",
      "result": true,
      "format": "jpg",
      "imagemagick_stack": "v1.0.0",
      "watermark_position": "bottom-right",
      "watermark_position_x": 10,
      "watermark_position_y": 10,
      "watermark_size": "25%",
      "watermark_url": ""
    "exported": {
      "use": ["watermarked", ":original"],
      "user": "YOUR_SFTP_USER",
      "robot": "/sftp/store",
      "host": "",
      "path": "uploads/make/this/dir/if/you/!_like/${file.url_name}",
      "url_template": "!_like/${file.url_name}"

Our /sftp/store robot blog posts

Over the years we wrote the following posts about Our /sftp/store robot on our blog:

Did you know?

You can easily combine Robots to create powerful workflows, unique to your business.
This is the power of Transloadit.