Import OPML

Bulk-subscribe from an OPML 2.0 document. Queues entries and returns at once — nothing is subscribed yet. Already-subscribed, duplicate and over-limit entries are skipped. Poll get_import_status for pending/succeeded/failed counts; report counts, never a completion time.

post/import_opml

Request

  • Base URL: https://newsmind.app/api/v1
  • URL: https://newsmind.app/api/v1/import_opml
  • Auth: OAuth 2 (authorization code, authorization URL https://newsmind.app/oauth/authorize, token URL https://newsmind.app/oauth/token, scopes: mcp)

Request body

opmlstring required

The OPML 2.0 XML document as a string. Must contain <outline xmlUrl="…"> entries.

folderstring

Optional override folder for every imported feed. If omitted, the OPML's own folder structure (parent <outline> titles) is preserved.

Response

Success

queuedinteger

Entries accepted into the import queue. Nothing is subscribed yet — poll get_import_status.

format_invalidinteger

Entries whose URL was unusable as written.

skipped_already_subscribedinteger
skipped_duplicate_in_opmlinteger

The same feed appeared more than once in this document.

skipped_already_queuedinteger

Already pending from an earlier import.

skipped_over_limitinteger

Beyond the plan's feed limit.

total_in_opmlinteger
etastring

Human-readable estimate of when the queue should drain. Advisory — report counts from get_import_status rather than this.

messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.