Ways in

SFTP

Upload with any SFTP client, scp, rsync or script. Files go straight into your library, and the folder you put them in decides how they're stored.

Connecting

Hoststring sftp.drop.media, port 22
Usernamestring Your account prefix, acme
Passwordstring An API key with files:write, or sign in with an SSH key added on the SFTP page in the app
$ sftp acme@sftp.drop.media
sftp> put chart.png
sftp> put board.pdf private/

Folders

The folder decides how a file is stored. Combine them in any order, at any depth:

private/folder Store as private.
public/folder Store as public.
expires-<time>/folder Delete after that long, e.g. expires-12h/, expires-30d/.
$ scp report.pdf acme@sftp.drop.media:private/expires-1d/
$ rsync -av exports/ acme@sftp.drop.media:private/expires-30d/

Anything else uses the account's defaults.

What happens to an upload

  • When a file finishes uploading it's checked like any other upload (file type, size and plan limits) and moved into the library, so the folder empties as files are stored.
  • A file that can't be stored fails the transfer with the reason, so your client or script sees the error. It's also an sftp.upload_failed event in Logs.
  • Each stored file sends a file.created webhook.
  • Ten failed logins from one IP address lock the account out for 15 minutes.

Plain FTP and WebDAV aren't offered.

See Nightly exports over SFTP for a full setup.