Skip to Content
put.ioDevelopers
Register an app

Add transfers

POSThttps://api.put.io/v2/transfers/add-multi

Adds each URL as a separate transfer. Duplicate and empty URLs are skipped. Failed URLs are listed in errors.

Requires an active plan; returns 402 otherwise.

Body

application/x-www-form-urlencoded

urlsstringRequired

JSON array of objects with url (required), save_parent_id and callback_url, matching the fields of /transfers/add.

Returns

200

statusstring
transfersarray
errorsarray

Errors

JSON with error_type, error_message, error_id and extra.

400urls is not a valid JSON array of objects.
402No active plan.
403TOO_MANY_URLS if the number of URLs exceeds the limit.
429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.