Skip to Content
put.ioDevelopers
Register an app

Share files

POSThttps://api.put.io/v2/files/share

Requires an active plan; returns 402 otherwise.

Body

application/x-www-form-urlencoded

file_idsstring

Comma-separated file ids.

cursorstring

Share all files of a cursor instead of file_ids.

exclude_idsstring

Comma-separated file ids to leave out.

friendsstringRequired

Comma-separated user names of friends, or everyone. Names that are not friends are ignored.

Returns

200

statusstring

Errors

JSON with error_type, error_message, error_id and extra.

400friends is missing, file_ids is not a list of integers, or ALREADY_SHARED if a parent folder is already shared.
402No active plan.
429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.