Struct Subscription 

pub struct Subscription {
    pub type: String,
    pub url: String,
    pub title: Option<String>,
    pub site_url: Option<String>,
    pub folder: Option<String>,
    pub fetch_hint: Option<FetchHint>,
    pub private: Option<bool>,
    pub created_at: String,
}

community.lexicon.rss.subscription — a subscription to a syndication feed (RSS / Atom / JSON Feed). Record key: tid.

url + createdAt are required; everything else is optional.

Public feeds only (and the reserved private marker)

atproto PDS records are public: anyone can read them via unauthenticated getRecord / listRecords and off the firehose, and they are retained even after deleteRecord. A private feed (a Substack …/feed/private/<token>, a Patreon ?auth=… feed, a Ghost members ?uuid= feed, a private-podcast token feed, or any URL that carries a secret token / key / auth credential) has its secret in the URL, so writing that URL here would leak paid / members-only access to the whole network.

Current decision: FeatherReader supports PUBLIC feeds only. A private feed is refused at the add / import boundary (see crate::feed::classify_feed_privacy) — it is never fetched, never stored, and no record (redacted or otherwise) is ever written. The server therefore holds NO private secret, which keeps “your data lives in your public PDS” 100% honest. Consequently every Subscription record actually written carries a real, public feed url, and [private] is always omitted.

The [private] field is retained ONLY as a documented, forward-compatible reserved marker for the eventual migration once atproto ships permissioned data / permission-sets (early-proposal as of mid-2026, bluesky-social/proposals#94). At that point a private feed’s secret can live in an owner-scoped, permission-gated collection and this record can reference it with private: true. Until then the field has no runtime behavior — nothing sets it and nothing branches on it.

Fields

type: String

The $type NSID discriminator; always nsid::SUBSCRIPTION.

url: String

Canonical feed URL (the RSS/Atom/JSON Feed document). Required.

Always a real, PUBLIC feed URL: private/secret-bearing feeds are refused at the add boundary (see the type-level docs), so no record with a withheld or redacted url is ever written.

title: Option<String>

Display title; a reader MAY override from feed metadata.

site_url: Option<String>

Human-facing site the feed belongs to.

folder: Option<String>

Optional at:// strong ref to a Folder record.

fetch_hint: Option<FetchHint>

Optional polling-cadence hint; readers MAY honor or ignore it.

private: Option<bool>

Reserved — no runtime behavior today.

FeatherReader currently supports public feeds only (private/secret-bearing feeds are refused at the add boundary), so nothing sets this and every written record omits it (None). It is kept as a documented, forward-compatible seam for the eventual migration once atproto ships permissioned data: at that point a private feed’s secret can live in an owner-scoped, permission-gated collection and this record can reference it with private: true. See the type-level docs.

created_at: String

Record creation time (ISO-8601 datetime). Required.

Implementations

impl Subscription

pub fn new(url: impl Into<String>, created_at: impl Into<String>) -> Self

Construct a minimal subscription with only the required fields.

Trait Implementations

impl Clone for Subscription

fn clone(&self) -> Subscription

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Subscription

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Subscription

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Subscription

impl PartialEq for Subscription

fn eq(&self, other: &Subscription) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Subscription

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Subscription