ink.branchline.listNotifications
List unread notifications for the authenticated viewer. Requires a valid session cookie; responds 401 otherwise. Notifications are derived from indexed records (no separate notification table) and grouped by subject; a group counts as unread when its latestAt is newer than the viewer's stored readAt for that group (see ink.branchline.markNotificationsRead). Three kinds are emitted: 'continuation' (someone grew one of the viewer's buds), 'seedGrant' (someone gave the viewer a seed), and 'bookmarkGrowth' (new buds on a story the viewer bookmarked).
Details · query
| Kind | query |
|---|---|
| Authority | branchline.ink |
| Indexed |
Query
query · GETParameters
query stringlimit
integerminimum: 1maximum: 50default: 20
Output
application/json#actor
objectProperties
#bookmarkGrowthView
objectA story the viewer bookmarked received new buds past the viewer's last dismissal.
Properties
minimum: 1
Format: 'bookmarkGrowth:{rootUri}'.
createdAt of the most recent qualifying new bud on this story.
Number of new buds since the viewer last dismissed this group (bounded for display).
minimum: 1
Root bud AT-URI of the bookmarked story.
#continuationView
objectOne of the viewer's buds received at least one child bud since the group was last read.
Properties
minimum: 1
Up to 10 unique actors who wrote qualifying child buds, most-recent actor first.
maxLength: 10
Stable identifier used with ink.branchline.markNotificationsRead. Format: 'continuation:{parentUri}'.
Timestamp of the most recent child bud in this group. Drives sort order.
AT-URI of the viewer's bud that was extended.
#seedGrantView
objectSomeone granted the viewer a seed.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
List notifications for the authenticated Zeens user. Merges likes, replies, follows, group-membership and group-photo events from the firehose.
-
The caller's notifications from Bluesky, BookHive, Popfeed, comics and Resenha, newest first.
-
List notifications for the requesting account, newest first. Requires auth.
-
Paginated notifications addressed to the requesting viewer, newest first. The viewer DID is read from the service-auth JWT (`iss` claim) — no `?viewer=` query parameter.
-
Notifications for the authenticated viewer (newest first). Includes read items; AppView may drop items older than 30 days.