Skip to Content
put.ioDevelopers
Register an app

Update a feed

POSThttps://api.put.io/v2/rss/{id}

Updates an RSS feed with the given parameters.

keyword, unwanted_keywords, delete_old_files and dont_process_whole_feed are replaced on every call; send their current values to keep them. title, rss_source_url and parent_dir_id are kept when omitted.

Requires an active plan; returns 402 otherwise.

Path

idintegerRequired

Body

application/x-www-form-urlencoded

titlestring

Title of the RSS feed as will appear on the site

rss_source_urlstring · uri

The URL of the RSS feed to be watched

parent_dir_idinteger

The file ID of the folder to place the RSS feed files in

delete_old_filesboolean

Should old files in the folder be deleted when space is low

dont_process_whole_feedboolean

Should the current items in the feed be ignored

keywordstring | null

Only items with titles that contain any of these words will be transferred (comma-separated list of words)

unwanted_keywordsstring

No items with titles that contain any of these words will be transferred (comma-separated list of words)

Returns

200

statusstring

Errors

JSON with error_type, error_message, error_id and extra.

400URL_NOT_VALID, FEED_CANNOT_FETCHED or FEED_CANNOT_PARSED if rss_source_url is not a valid feed. NotFolder if parent_dir_id is not a folder. Also returned when delete_old_files or dont_process_whole_feed is not a boolean.
402No active plan.
404Feed not found, or parent_dir_id is not a folder you can write to.
429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.