app.bsky.notification.getGroupedNotifications
[UNSTABLE - DO NOT USE THIS ENDPOINT WHILE THIS NOTE IS HERE] Enumerate notifications for the requesting account, pre-grouped for rendering. Supersedes listNotifications. Requires auth.
Details · query
| Kind | query |
|---|---|
| Authority | notification.bsky.app |
| Indexed |
Query
query · GETParameters
query stringcursor
stringmaxLength: 1024
feed
stringWhich notification feed to return. Grouping behavior varies by feed: notifications about follows might be grouped in 'all' and ungrouped (or rather, in single-item groups) in 'followers'.
maxLength: 32default: "all"knownValues: all | people-i-follow | conversations | followers | activity
limit
integerMaximum number of groups to return.
minimum: 1maximum: 50default: 30
#contactMatchNotification
objectA contact of the requesting account joined Bluesky.
Properties
#followBackNotification
objectAn actor followed the requesting account back, possibly via a starter pack.
Properties
starterPack
string · at-uri#followGroup
objectGroup of actors who followed the requesting account.
Properties
minLength: 1
#followItem
objectAn actor who followed the requesting account, possibly via a starter pack.
Properties
starterPack
string · at-uri#generatorLikeGroup
objectGroup of likes by different actors on the same feed generator.
Properties
minLength: 1
#generatorLikeItem
objectOne actor who liked the feed generator in the group.
Properties
#group
objectContains common metadata and kind-specific data for a notification group or individual notification.
Properties
minimum: 1
maxLength: 256
- #likeGroup
- #multiPostLikeGroup
- #multiPostRepostGroup
- #multiPostLikeViaRepostGroup
- #multiPostRepostViaRepostGroup
- #repostGroup
- #likeViaRepostGroup
- #repostViaRepostGroup
- #followGroup
- #subscribedPostGroup
- #generatorLikeGroup
- #replyNotification
- #quoteNotification
- #mentionNotification
- #followBackNotification
- #verifiedNotification
- #unverifiedNotification
- #starterPackJoinedNotification
- #contactMatchNotification
#likeGroup
objectGroup of likes by different actors on the same post.
#likeItem
objectOne actor who liked the group's post.
Properties
#likeViaRepostGroup
objectGroup of likes by different actors on the same post via the requesting account's repost.
Properties
minLength: 1
#likeViaRepostItem
objectOne actor who liked the group's post via the requesting account's repost.
Properties
#mentionNotification
objectA post mentioning the requesting account.
#multiPostLikeGroup
objectGroup of likes by the same actor on different posts.
Properties
minLength: 2
#multiPostLikeItem
objectOne post which was liked by the group's actor.
Properties
#multiPostLikeViaRepostGroup
objectGroup of likes by the same actor on different posts via the requesting account's reposts.
Properties
minLength: 2
#multiPostLikeViaRepostItem
objectOne post which was liked by the group's actor via the requesting account's repost.
#multiPostRepostGroup
objectGroup of reposts by the same actor of different posts.
Properties
minLength: 2
#multiPostRepostItem
objectOne post which was reposted by the group's actor.
Properties
#multiPostRepostViaRepostGroup
objectGroup of reposts by the same actor of different posts via the requesting account's reposts.
Properties
minLength: 2
#multiPostRepostViaRepostItem
objectOne post which was reposted by the group's actor via the requesting account's repost.
#quoteNotification
objectA post quoting a post by the requesting account.
#replyNotification
objectA reply to a post by the requesting account or to a thread they are participating in.
#repostGroup
objectGroup of reposts by different actors of the same post.
Properties
minLength: 1
#repostItem
objectOne actor who reposted the group's post.
Properties
#repostViaRepostGroup
objectGroup of reposts by different actors of the same post via the requesting account's repost.
Properties
minLength: 1
#repostViaRepostItem
objectOne actor who reposted the group's post via the requesting account's repost.
Properties
#starterPackJoinedNotification
objectAn actor joined Bluesky via a starter pack created by the requesting account.
Properties
#subscribedPostGroup
objectGroup of new posts by actors the requesting account subscribes to.
Properties
minLength: 1
#subscribedPostItem
objectOne new post by an actor the requesting account subscribes to.
#unverifiedNotification
objectA verification of the requesting account was removed.
Properties
#verifiedNotification
objectAn actor verified the requesting account.
Properties
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Enumerate notifications for the requesting account. Requires auth.
-
List notifications for the authenticated Zeens user. Merges likes, replies, follows, group-membership and group-photo events from the firehose.
-
Enumerate notifications for the requesting account. Requires auth.
-
Enumerate notifications for the requesting account. Requires auth.
-
The caller's Activity, newest first, from every group on this host they're in: what answers something of theirs, what names them, and, where they asked for everything new, each new event or thread. Only what they may still read, as it is now.