app.bsky.unspecced.getAtmosphereTimeline
#main
Get the authenticated viewer's Atmosphere activity timeline. Groups contain visible activities from the returned page.
Parameters
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| cursor | string | - | ❌ | - |
Output
- Encoding: application/json
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| cursor | string | - | ❌ | - |
| feed | array of union #activityItem #activityActorGroup #activitySubjectGroup | - | ✅ | - |
#activityRecord
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| uri | string (at-uri) | - | ✅ | - |
| cid | string (cid) | - | ✅ | - |
| indexedAt | string (datetime) | - | ✅ | - |
#viewerState
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| subscribed | boolean | - | ✅ | - |
#activityItem
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| record | #activityRecord | - | ✅ | - |
| collection | string (nsid) | - | ✅ | - |
| viewerState | #viewerState | - | ✅ | - |
| relatedActivity | array of #activityRelatedGroup | - | ❌ | Collection-specific activity references targeting this item's record. Article creations with related activity remain standalone; only the parent item's view is hydrated. |
| bskyPostRef | com.atproto.repo.strongRef | - | ❌ | - |
| viewBskyPost | app.bsky.feed.defs#postView | - | ❌ | - |
| view | union of app.bsky.embed.external#viewArticle app.bsky.embed.external#viewArticlePublication app.bsky.embed.external#viewGallery app.bsky.embed.external#viewLivestream app.bsky.feed.defs#postView | - | ❌ | - |
#activityActorGroup
Activities by one actor in one collection, positioned at the newest group item. Only the newest item is hydrated. Article creations with related activity remain standalone.
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| id | string | - | ✅ | - |
| collection | string (nsid) | - | ✅ | - |
| indexedAt | string (datetime) | - | ✅ | - |
| actor | string (did) | - | ✅ | - |
| item | #activityItem | - | ✅ | - |
| uris | array of string | - | ✅ | All visible group item URIs, including the hydrated item, in newest-first timeline order. |
#activitySubject
The shared target of grouped activities, not an activity itself.
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| uri | string (at-uri) | - | ✅ | - |
| viewerState | #viewerState | - | ✅ | - |
| bskyPostRef | com.atproto.repo.strongRef | - | ❌ | - |
| viewBskyPost | app.bsky.feed.defs#postView | - | ❌ | - |
| view | union of app.bsky.embed.external#viewArticle app.bsky.embed.external#viewArticlePublication app.bsky.embed.external#viewGallery | - | ✅ | - |
#activityGroupItem
An unhydrated group item. Its actor DID is the authority of its record URI.
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| record | #activityRecord | - | ✅ | - |
| collection | string (nsid) | - | ✅ | - |
#activityRelatedGroup
Visible activities in one collection targeting the parent item's record, without a time window. Contains references and profiles only, not a shared subject or hydrated action views. Buckets follow newest-first first appearance.
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| collection | string (nsid) | - | ✅ | - |
| activities | array of #activityGroupItem | - | ✅ | Visible activity references in newest-first timeline order. Every activity has the bucket's collection. |
| actors | array of app.bsky.actor.defs#profileViewBasic | - | ✅ | Unique actors in first-appearance order among the bucket's activities. |
#activitySubjectGroup
Activities in one collection sharing a target, by at least two distinct actors, positioned at the newest group item. Article recommendations and shares group separately across the returned page without a time window. Article creations are not subject-group items. Publication subscriptions and gallery favorites retain age-based grouping windows.
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| id | string | - | ✅ | - |
| collection | string (nsid) | - | ✅ | - |
| indexedAt | string (datetime) | - | ✅ | - |
| subject | #activitySubject | - | ✅ | - |
| activities | array of #activityGroupItem | - | ✅ | Visible group items in newest-first timeline order. Every activity has the group's collection. |
| actors | array of app.bsky.actor.defs#profileViewBasic | - | ✅ | Unique actors in first-appearance order among group items. At least two distinct actors are required. |