app.bsky.unspecced.getAtmosphereTimelineV2

Get the requesting account’s Atmosphere activity timeline, pre-grouped for rendering. Requires auth.

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.Params

Bases: ParamsModelBase

Parameters model for app.bsky.unspecced.getAtmosphereTimelineV2.

field cursor: str | None = None

Cursor.

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.ParamsDict

Bases: TypedDict

cursor: NotRequired[str | None]

Cursor.

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.Response

Bases: ResponseModelBase

Output data model for app.bsky.unspecced.getAtmosphereTimelineV2.

field cursor: str | None = None

Cursor.

field feed: List[models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivityItem | models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivityActorGroup | models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivitySubjectGroup | DotDict] [Required]

Activities and activity groups, sorted newest first by indexedAt. Groups and relatedActivity only contain activities from the same page of results. Activities by actors unavailable to the viewer are omitted before grouping. Clients should ignore entry types they do not recognize.

field related_views: List[models.AppBskyActorDefs.ProfileViewBasic | DotDict] [Required]

Reusable views referenced by feed entries. Views shared across entries appear once to avoid duplication. Always includes the profile of the actor of every activityItem and activityActorGroup, plus the profiles of at most the newest 3 distinct actors in each activitySubjectGroup and in each collection of an activityItem’s relatedActivity. Ex: for a subject group of 12 recommendations, only the profiles of the 3 newest recommenders are included; clients can fetch the rest with app.bsky.actor.getProfiles.

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.ActivityItem

Bases: ModelBase

Definition model for app.bsky.unspecced.getAtmosphereTimelineV2. A single activity with its hydrated subject. An activity that creates content, such as publishing an article, is always a standalone item when other activities on the same page target that content; those activities are attached as relatedActivity. Activities whose subject is unavailable to the viewer are omitted from the timeline.

field actor: Did [Required]

Actor.

field collection: Nsid [Required]

The collection of the activity record. Ex: site.standard.graph.recommend.

field indexed_at: DateTime [Required]

When the activity was indexed. Determines the item’s position in the feed, even when relatedActivity contains newer activities.

field ref: models.ComAtprotoRepoStrongRef.Main [Required]

Ref.

field related_activity: List[models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivityItemRelatedActivity] | None = None

All available activities on the same page that target content created by this activity, newest first. Ex: recommendations of a newly published article. Only present on activities that create content. Activities targeting content created on an earlier page appear as their own feed entries instead.

field subject: models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivitySubject [Required]

Subject.

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.ActivityItemRelatedActivity

Bases: ModelBase

Definition model for app.bsky.unspecced.getAtmosphereTimelineV2.

field actor: Did [Required]

Actor.

field collection: Nsid [Required]

Collection.

field indexed_at: DateTime [Required]

Indexed at.

field ref: models.ComAtprotoRepoStrongRef.Main [Required]

Ref.

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.ActivitySubject

Bases: ModelBase

Definition model for app.bsky.unspecced.getAtmosphereTimelineV2. The hydrated content an activity targets. For activities that create content, such as publishing an article, the subject is the created record itself.

field bsky_post_ref: models.ComAtprotoRepoStrongRef.Main | None = None
field bsky_post_view: models.AppBskyFeedDefs.PostView | None = None
field ref: models.ComAtprotoRepoStrongRef.Main [Required]

The record backing the view. Ex: the site.standard.document of an article.

field view: models.AppBskyEmbedExternal.ViewArticle | models.AppBskyEmbedExternal.ViewArticlePublication | models.AppBskyEmbedExternal.ViewGallery | models.AppBskyEmbedExternal.ViewLivestream | DotDict [Required]

View.

Constraints:

  • __module__ = atproto_client.models.unknown_union

  • __firstlineno__ = 17

  • __doc__ = Annotation for open ref unions: an unrecognized $type falls back to DotDict. Applied to t.Union[<known members>, 'dot_dict.DotDictType']. Members are discriminated by py_type as usual, so a known type that fails validation still raises. Only a $type that matches no member, or a missing one, degrades to a DotDict.

  • __get_pydantic_core_schema__ = <bound method UnknownUnionFallback.__get_pydantic_core_schema__ of <class ‘atproto_client.models.unknown_union.UnknownUnionFallback’>>

  • __static_attributes__ = ()

  • __dict__ = {‘__module__’: ‘atproto_client.models.unknown_union’, ‘__firstlineno__’: 17, ‘__doc__’: “Annotation for open ref unions: an unrecognized $type falls back to DotDict.nnApplied to t.Union[<known members>, 'dot_dict.DotDictType']. Members are discriminated byn``py_type`` as usual, so a known type that fails validation still raises. Only a $type thatnmatches no member, or a missing one, degrades to a DotDict.n”, ‘__get_pydantic_core_schema__’: <classmethod(<function UnknownUnionFallback.__get_pydantic_core_schema__ at 0x725769ac91c0>)>, ‘__static_attributes__’: (), ‘__dict__’: <attribute ‘__dict__’ of ‘UnknownUnionFallback’ objects>, ‘__weakref__’: <attribute ‘__weakref__’ of ‘UnknownUnionFallback’ objects>}

  • __weakref__ = <attribute ‘__weakref__’ of ‘UnknownUnionFallback’ objects>

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.ActivityActorGroup

Bases: ModelBase

Definition model for app.bsky.unspecced.getAtmosphereTimelineV2. Activities by one actor in one collection close together in time, such as several articles published by the same author. Activities that create content with relatedActivity are never grouped. Positioned in the feed at its newest activity.

field activities: List[models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivityActorGroupItem] [Required]

All activities in the group, newest first.

Constraints:

  • min_length = 2

field actor: Did [Required]

Actor.

field collection: Nsid [Required]

Collection.

field indexed_at: DateTime [Required]

When the group’s newest activity was indexed.

field subjects: List[models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivitySubject] [Required]

Hydrated subjects of the group’s activities, newest first. Currently only the newest subject is included; clients can hydrate the rest from the subject URIs in activities.

Constraints:

  • min_length = 1

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.ActivityActorGroupItem

Bases: ModelBase

Definition model for app.bsky.unspecced.getAtmosphereTimelineV2.

field indexed_at: DateTime [Required]

Indexed at.

field ref: models.ComAtprotoRepoStrongRef.Main [Required]

Ref.

field subject: AtUri [Required]

The content the activity targets. Matches ref.uri for activities that create content.

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.ActivitySubjectGroup

Bases: ModelBase

Definition model for app.bsky.unspecced.getAtmosphereTimelineV2. Activities by at least two actors in one collection targeting the same subject, such as several recommendations of an article published on an earlier page. Positioned in the feed at its newest activity.

field activities: List[models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivitySubjectGroupItem] [Required]

All activities in the group, newest first.

Constraints:

  • min_length = 2

field collection: Nsid [Required]

Collection.

field indexed_at: DateTime [Required]

When the group’s newest activity was indexed.

field subject: models.AppBskyUnspeccedGetAtmosphereTimelineV2.ActivitySubject [Required]

Subject.

class atproto_client.models.app.bsky.unspecced.get_atmosphere_timeline_v2.ActivitySubjectGroupItem

Bases: ModelBase

Definition model for app.bsky.unspecced.getAtmosphereTimelineV2.

field actor: Did [Required]

Actor.

field indexed_at: DateTime [Required]

Indexed at.

field ref: models.ComAtprotoRepoStrongRef.Main [Required]

Ref.