v1

latestOpenAPI 3.0.3AGPL-3.0-only2026-07-17120116247.0 KB
user APIs

Upload a single file

Upload a single file for the logged in user to an existing directory. This API does not use multipart/form-data and so no temporary files are created server side but only a single file can be uploaded as POST body

post/user/files/upload

Query parameters

pathstring required

Full file path. It must be path encoded, for example the path "my dir/àdir/file.txt" must be sent as "my%20dir%2F%C3%A0dir%2Ffile.txt". The parent directory must exist. If a file with the same name already exists, it will be overwritten

mkdir_parentsboolean

Create parent directories if they do not exist?

Headers

X-SFTPGO-MTIMEinteger

File modification time as unix timestamp in milliseconds

Response

successful operation

messagestring

message, can be empty

errorstring

error description if any