Skip to Content
put.ioDevelopers
Register an app

Update settings

POSThttps://api.put.io/v2/account/settings

Send only the settings you want to change. Booleans are the strings true or false.

Changing password or mail also requires current_password.

Only put.io's own apps can call this.

Body

application/x-www-form-urlencoded

usernamestring
mailstring · email

Requires current_password.

passwordstring · password

New password. Requires current_password.

current_passwordstring · password

Required when changing mail or password.

default_download_folderinteger · int64
is_invisibleboolean
subtitle_languagesstring

Comma-separated language codes, at most two.

callback_urlstring
pushover_tokenstring
sort_bystring · enum
NAME_ASCNAME_DESCSIZE_ASCSIZE_DESCDATE_ASCDATE_DESCTYPE_ASCTYPE_DESCWATCH_ASCWATCH_DESCMODIFIED_ASCMODIFIED_DESC
transfer_sort_bystring · enum
NAME_ASCNAME_DESCETA_ASCETA_DESCDATAUPLOADED_ASCDATAUPLOADED_DESCDATADOWNLOADED_ASCDATADOWNLOADED_DESCDATEADDED_ASCDATEADDED_DESCSTATUS_ASCSTATUS_DESCPEER_ASCPEER_DESCRATIO_ASCRATIO_DESC
next_episodeboolean
trash_enabledboolean
history_enabledboolean
localestring
themestring · enum
darklightauto

Returns

200

statusstring

Errors

JSON with error_type, error_message, error_id and extra.

400Invalid input. Common error_type values: INVALID_SETTING (unknown key), INVALID_VALUE (bad value), INVALID_CURRENT_PASSWORD. Per-setting checks return others, such as INVALID_MAIL or INVALID_NEW_PASSWORD.
409SAME_USERNAME or EXISTING_MAIL.
429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.