Feeds

Subscribe to a feed by URL.

Requires manage scope. The same source URL is shared across all subscribers (one fetch serves everyone) — but your label and read-state stay private.

post/v1/feeds

Request

  • Base URL: https://api.inboxy.net
  • URL: https://api.inboxy.net/v1/feeds
  • Auth: HTTP bearer

Request body

urlstring uri required
labelstring

Response

Subscribed.

idstring uuid required

Per-user subscription id. Use this everywhere — the shared feed_sources id is never exposed.

labelstring nullable
urlstring uri required
titlestring nullable
descriptionstring nullable
homepage_linkstring nullable
languagestring nullable
status'active' | 'error' | 'inactive' required
last_polled_atinteger nullable

Unix seconds.

last_errorstring nullable
subscribed_atinteger required
totalinteger

Total articles in this feed (across all subscribers).

unreadinteger required

Your unread article count.

Changes

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