Get import status

Returns the user's pending / succeeded / failed import counts (import_opml, or a subscribe_to_feed that answered queued) plus the most recent failures, and the addresses subscribe_to_feed refused this week: rechecking, added or refused. Report counts to the user, not a completion time.

post/get_import_status

Request

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

Request body

object required

Response

Success

pendinginteger

Feeds still waiting for the worker to validate + insert.

succeededinteger

Feeds successfully imported in the last 24 hours.

failedinteger

Feeds the worker rejected, all-time (validation error — dead URL, non-feed content, etc.).

failed_recentinteger

Failed imports inside the last 7 days — the recency window the import_failures notice uses. v0.33.0.

retryinginteger

Failures that still have an automatic retry scheduled. NOT losses — the worker will validate them again, so do not offer to re-add them by hand. Undocumented here since v0.54.0; added v1.150.0 (#173).

next_retry_atstring date-time nullable

When the earliest scheduled retry runs. Omitted when nothing is scheduled. v1.150.0 (#173).

etastring

Queue STATE, not a time: "queue is empty" or "still importing". Deliberately carries no duration — the queue is shared across customers and most of the wall-clock is publishers' servers responding. Report the pending/succeeded/failed counts to the user, never a completion time.

advicestring nullable

Present when failed_recent > 0: assistant-directed instruction to relay the failed URLs and reasons and offer next steps. v0.33.0.

refused_subscribes_notestring

Present with refused_subscribes: what each state means and what to tell the user. v1.281.7 (#367).

refused_subscribes_unavailableboolean

Present, true, only when the refused-subscribes read failed: an absent refused_subscribes then means nothing, not that nothing was refused. v1.281.7 (#367).

failure_summary_truncatedboolean

Present only when failure_summary covered fewer rows than failed. Its buckets are then a sample, not a census — do not quote them as totals. v1.149.0 (#174).

failure_summary_countedinteger

How many failed rows failure_summary actually read, when that is fewer than failed. v1.149.0 (#174).

Changes

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