Skip to Content
put.ioDevelopers
Register an app

Upload a file

POSThttps://upload.put.io/v2/files/upload

If the uploaded file is a torrent file, starts it as a transfer. Flag fields count only when set to the string true. **This endpoint must be used with upload.put.io domain.**

Body

multipart/form-data

filefileRequired

Content of the file

filenamestring

Override file name

parent_idinteger

Where to put file

torrentstring · enum

Fail unless the file is a torrent.

true
no-torrentstring · enum

Store a torrent file as a file instead of starting a transfer.

true
overwritestring · enum

Overwrite a file with the same name in the target folder.

true
updated-atstring · date-time

Modification time of the file, in RFC 3339.

callback_urlstring · uri

URL to call when the started transfer completes.

Returns

200

fileobject
transferobject

Errors

JSON with error_type, error_message, error_id and extra.

429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.