Create a feed · put.io Developers

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

Creates an RSS feed with the given parameters. The created feed object is returned.

Requires an active plan; returns 402 otherwise.

Body

application/x-www-form-urlencoded

titlestringRequired

Title of the RSS feed as will appear on the site

rss_source_urlstring · uriRequired

The URL of the RSS feed to be watched

parent_dir_idinteger

ID of the folder for new files. 0 means the root folder.

delete_old_filesstring · enum

Send on to delete old files in the folder when space is low. Any other value, or leaving it out, turns it off.

on

dont_process_whole_feedboolean

Should the current items in the feed, at creation time, 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 · a feed object

idinteger

titlestring

rss_source_urlstring · uri

parent_dir_idinteger

parentdiridinteger

Old name of parent_dir_id.

delete_old_filesboolean

+ 11 more fields

Errors

JSON with error_type, error_message, error_id and extra.

400URL_REQUIRED, TITLE_REQUIRED, URL_NOT_VALID, FEED_CANNOT_FETCHED or FEED_CANNOT_PARSED. NotFolder if parent_dir_id is not a folder. Also returned when dont_process_whole_feed is not a boolean.

402No active plan.

403TOO_MANY_RSS_FEEDS if the account has reached the feed limit.

404parent_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.