Skip to Content
put.ioDevelopers
Register an app

Create a ZIP

POSThttps://api.put.io/v2/zips/create

Starts a zipping job for up to 1000 files or folders. Send file_ids, file_id or cursor. Poll /zips/{id} with the returned zip_id until zip_status is DONE.

Body

application/x-www-form-urlencoded

file_idsarray

File IDs to include (max 1000). A comma-separated string also works. user_file_ids is an alias.

file_idinteger

A single file ID, instead of file_ids. Also accepted as a query parameter.

cursorstring

Select every file from a /files/list cursor, instead of file_ids.

exclude_idsstring

Comma-separated file IDs to leave out.

Returns

200

zip_idinteger

Errors

JSON with error_type, error_message, error_id and extra.

400No readable files selected, more than 1000 files, or a non-integer file_id or file_ids.
403ZIP_TOTAL_SIZE_EXCEEDED when the selection is larger than 1TB.
429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.