{ "lexicon": 1, "id": "app.bsky.notification.getGroupedNotifications", "defs": { "main": { "type": "query", "description": "[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.", "parameters": { "type": "params", "properties": { "feed": { "type": "string", "description": "Which 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": 32, "knownValues": [ "all", "people-i-follow", "conversations", "followers", "activity" ], "default": "all" }, "limit": { "type": "integer", "description": "Maximum number of groups to return.", "minimum": 1, "maximum": 50, "default": 30 }, "cursor": { "type": "string", "maxLength": 1024 } } }, "output": { "encoding": "application/json", "schema": { "type": "object", "required": [ "groups" ], "properties": { "cursor": { "type": "string", "maxLength": 1024 }, "groups": { "type": "array", "description": "Notification groups or individual notifications, newest first. Clients should ignore kinds they do not recognize. Grouping behavior depends on the kind and selected feed.", "items": { "type": "ref", "ref": "#group" } }, "seenAt": { "type": "string", "format": "datetime" }, "relatedViews": { "type": "array", "description": "Reusable views referenced by notifications. Views shared across notifications appear once to avoid duplication. Each group contributes only its first 10 of each related view to this array. Ex: for a group containing likes in a post, we might have a large number of likeItem (e.g., 50) in a group, but only the profile views for the newest 10 items will be included here.", "items": { "type": "union", "refs": [ "app.bsky.actor.defs#profileViewBasic", "app.bsky.feed.defs#blockedPost", "app.bsky.feed.defs#generatorView", "app.bsky.feed.defs#notFoundPost", "app.bsky.feed.defs#postView", "app.bsky.graph.defs#starterPackViewBasic" ] } } } } } }, "group": { "type": "object", "description": "Contains common metadata and kind-specific data for a notification group or individual notification.", "required": [ "id", "isRead", "indexedAt", "count", "kind" ], "properties": { "id": { "type": "string", "maxLength": 256 }, "isRead": { "type": "boolean" }, "indexedAt": { "type": "string", "format": "datetime" }, "count": { "type": "integer", "minimum": 1 }, "kind": { "type": "union", "refs": [ "#likeGroup", "#multiPostLikeGroup", "#multiPostRepostGroup", "#multiPostLikeViaRepostGroup", "#multiPostRepostViaRepostGroup", "#repostGroup", "#likeViaRepostGroup", "#repostViaRepostGroup", "#followGroup", "#subscribedPostGroup", "#generatorLikeGroup", "#replyNotification", "#quoteNotification", "#mentionNotification", "#followBackNotification", "#verifiedNotification", "#unverifiedNotification", "#starterPackJoinedNotification", "#contactMatchNotification" ] } } }, "likeGroup": { "type": "object", "description": "Group of likes by different actors on the same post.", "required": [ "post", "items" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "items": { "type": "array", "minLength": 1, "items": { "type": "ref", "ref": "#likeItem" } } } }, "likeItem": { "type": "object", "description": "One actor who liked the group's post.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" } } }, "multiPostLikeGroup": { "type": "object", "description": "Group of likes by the same actor on different posts.", "required": [ "actor", "items" ], "properties": { "actor": { "type": "string", "format": "did" }, "items": { "type": "array", "minLength": 2, "items": { "type": "ref", "ref": "#multiPostLikeItem" } } } }, "multiPostLikeItem": { "type": "object", "description": "One post which was liked by the group's actor.", "required": [ "post" ], "properties": { "post": { "type": "string", "format": "at-uri" } } }, "multiPostRepostGroup": { "type": "object", "description": "Group of reposts by the same actor of different posts.", "required": [ "actor", "items" ], "properties": { "actor": { "type": "string", "format": "did" }, "items": { "type": "array", "minLength": 2, "items": { "type": "ref", "ref": "#multiPostRepostItem" } } } }, "multiPostRepostItem": { "type": "object", "description": "One post which was reposted by the group's actor.", "required": [ "post" ], "properties": { "post": { "type": "string", "format": "at-uri" } } }, "multiPostLikeViaRepostGroup": { "type": "object", "description": "Group of likes by the same actor on different posts via the requesting account's reposts.", "required": [ "actor", "items" ], "properties": { "actor": { "type": "string", "format": "did" }, "items": { "type": "array", "minLength": 2, "items": { "type": "ref", "ref": "#multiPostLikeViaRepostItem" } } } }, "multiPostLikeViaRepostItem": { "type": "object", "description": "One post which was liked by the group's actor via the requesting account's repost.", "required": [ "post", "viaRepost" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "viaRepost": { "type": "string", "format": "at-uri" } } }, "multiPostRepostViaRepostGroup": { "type": "object", "description": "Group of reposts by the same actor of different posts via the requesting account's reposts.", "required": [ "actor", "items" ], "properties": { "actor": { "type": "string", "format": "did" }, "items": { "type": "array", "minLength": 2, "items": { "type": "ref", "ref": "#multiPostRepostViaRepostItem" } } } }, "multiPostRepostViaRepostItem": { "type": "object", "description": "One post which was reposted by the group's actor via the requesting account's repost.", "required": [ "post", "viaRepost" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "viaRepost": { "type": "string", "format": "at-uri" } } }, "repostGroup": { "type": "object", "description": "Group of reposts by different actors of the same post.", "required": [ "post", "items" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "items": { "type": "array", "minLength": 1, "items": { "type": "ref", "ref": "#repostItem" } } } }, "repostItem": { "type": "object", "description": "One actor who reposted the group's post.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" } } }, "likeViaRepostGroup": { "type": "object", "description": "Group of likes by different actors on the same post via the requesting account's repost.", "required": [ "post", "viaRepost", "items" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "viaRepost": { "type": "string", "format": "at-uri" }, "items": { "type": "array", "minLength": 1, "items": { "type": "ref", "ref": "#likeViaRepostItem" } } } }, "likeViaRepostItem": { "type": "object", "description": "One actor who liked the group's post via the requesting account's repost.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" } } }, "repostViaRepostGroup": { "type": "object", "description": "Group of reposts by different actors of the same post via the requesting account's repost.", "required": [ "post", "viaRepost", "items" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "viaRepost": { "type": "string", "format": "at-uri" }, "items": { "type": "array", "minLength": 1, "items": { "type": "ref", "ref": "#repostViaRepostItem" } } } }, "repostViaRepostItem": { "type": "object", "description": "One actor who reposted the group's post via the requesting account's repost.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" } } }, "followGroup": { "type": "object", "description": "Group of actors who followed the requesting account.", "required": [ "items" ], "properties": { "items": { "type": "array", "minLength": 1, "items": { "type": "ref", "ref": "#followItem" } } } }, "followItem": { "type": "object", "description": "An actor who followed the requesting account, possibly via a starter pack.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" }, "starterPack": { "type": "string", "format": "at-uri" } } }, "subscribedPostGroup": { "type": "object", "description": "Group of new posts by actors the requesting account subscribes to.", "required": [ "items" ], "properties": { "items": { "type": "array", "minLength": 1, "items": { "type": "ref", "ref": "#subscribedPostItem" } } } }, "subscribedPostItem": { "type": "object", "description": "One new post by an actor the requesting account subscribes to.", "required": [ "actor", "post" ], "properties": { "actor": { "type": "string", "format": "did" }, "post": { "type": "string", "format": "at-uri" }, "parent": { "type": "string", "format": "at-uri", "description": "The post this one replies to, if it is a reply." } } }, "generatorLikeGroup": { "type": "object", "description": "Group of likes by different actors on the same feed generator.", "required": [ "generator", "items" ], "properties": { "generator": { "type": "string", "format": "at-uri" }, "items": { "type": "array", "minLength": 1, "items": { "type": "ref", "ref": "#generatorLikeItem" } } } }, "generatorLikeItem": { "type": "object", "description": "One actor who liked the feed generator in the group.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" } } }, "replyNotification": { "type": "object", "description": "A reply to a post by the requesting account or to a thread they are participating in.", "required": [ "post", "parent" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "parent": { "type": "string", "format": "at-uri" } } }, "quoteNotification": { "type": "object", "description": "A post quoting a post by the requesting account.", "required": [ "post" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "parent": { "type": "string", "format": "at-uri" } } }, "mentionNotification": { "type": "object", "description": "A post mentioning the requesting account.", "required": [ "post" ], "properties": { "post": { "type": "string", "format": "at-uri" }, "parent": { "type": "string", "format": "at-uri" } } }, "followBackNotification": { "type": "object", "description": "An actor followed the requesting account back, possibly via a starter pack.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" }, "starterPack": { "type": "string", "format": "at-uri" } } }, "verifiedNotification": { "type": "object", "description": "An actor verified the requesting account.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" } } }, "unverifiedNotification": { "type": "object", "description": "A verification of the requesting account was removed.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" } } }, "starterPackJoinedNotification": { "type": "object", "description": "An actor joined Bluesky via a starter pack created by the requesting account.", "required": [ "actor", "starterPack" ], "properties": { "actor": { "type": "string", "format": "did" }, "starterPack": { "type": "string", "format": "at-uri" } } }, "contactMatchNotification": { "type": "object", "description": "A contact of the requesting account joined Bluesky.", "required": [ "actor" ], "properties": { "actor": { "type": "string", "format": "did" } } } } }