Import list items

Imports list items (in the format supported by Checkvist's import function), organised into a hierarchy according to the input. Items are added to the beginning of the target list. Returns the created items.

When OPML is imported into a list that has no items — an empty list, or any list imported with replace_existing=true — the list is renamed to the OPML /opml/head/title. The list's tags are also taken from that title: #tags in it replace the list's current tags, and a title without #tags leaves the list untagged.

Large imports are slow: allow at least a minute for the request to return, and do not retry it before then — a retry can import the same items twice.

Files can be attached to the import by sending the request as multipart/form-data and adding one file part per attachment, named add_files[1], add_files[2], … . All the files are attached to the first imported item. Attachments require a PRO account and available upload space; for non-PRO users the files are silently ignored and the items are still imported.