Taxonomy & Subscriptions

A Site only receives feed items for topics it's subscribed to. Zero subscriptions means zero articles — there is no implicit "everything" default.

List available topics

GET /api/v1/taxonomy

Requires subscription.manage. Returns every topic (category) FeedCentral currently classifies articles into, with its key, display name, and parent (if it's a sub-topic).

Read your Site's current subscriptions

GET /api/v1/subscriptions

Requires subscription.manage. Returns the topic keys your Site currently subscribes to.

Replace your Site's subscriptions

PUT /api/v1/subscriptions

Requires subscription.manage. This is a full replace, not an incremental add/remove — send the complete set of topic keys you want subscribed. An unknown category key is rejected (400 MALFORMED_REQUEST) before anything is written; a request either fully succeeds or changes nothing.

Parent topics include their children

Subscribing to a parent topic automatically includes articles classified under any of its sub-topics — you don't need to separately subscribe to each child.

Why this is a separate scope from feed.read

Being able to read the feed and being able to change what a Site receives are different capabilities — a Credential can hold one without the other.