Turn a subscription on or off
A disabled feed contributes no items and no unread count. Someone else's subscription is 404.
Sends a real request with your token. Prefer a read-only token; it is kept in this browser's storage.
A disabled feed contributes no items and no unread count. Someone else's subscription is 404.
AuthorizationBearer <token>A personal access token (rsk_…) or a Supabase access token.
id*string^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$application/json- body
enabled*booleanThe subscription
application/json- response
id*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidfeed_url*stringtitle*stringsite_url*string|nullfavicon_url*string|nullcolor*string|nullenabled*booleanlast_fetched_at*string|nulllast_error_code*|Why the last fetch failed: feed-unreachable, feed-empty, feed-not-rss, feed-gone, feed-blocked, feed-forbidden, feed-not-found, feed-stale
curl -X PATCH 'https://www.ressource.social/api/v1/rss/subscriptions/string' \ -H 'Content-Type: application/json' \ -d '{ "enabled": true}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "feed_url": "string", "title": "string", "site_url": "string", "favicon_url": "string", "color": "string", "enabled": true, "last_fetched_at": "string", "last_error_code": "string"}Re-check a failing feed now POST
Fetches the feed again and records the outcome in `last_error_code` (null when it answered). A feed that answers is refreshed at once.
Search everything the caller can reach, in one request GET
`personal`: the caller's own folders, tags and sources (typo-tolerant). `community`: other people's sources the caller can read — shared into one of the caller's communities, or public in their owner's Library — never the caller's own, so the two never overlap. `publicCommunities` and `publicUsers`: discovery, which degrades to empty rather than failing the request. A query under two characters answers every section empty. `organization_id` keeps only the caller's own sources shared into that community (members only); folders, tags and the other sections are unaffected. `folders` / `tags` / `bookmarks` are clamped to 0–25 / 0–25 / 0–50. Abort a superseded request: nothing is cached.