~ knotless Search/
↑↓ move↵ open⇧↵ all results

chadtmiller.com/hud

A remote MCP server that shows atproto records as interactive UI inside MCP Apps hosts

0
0
668 lines · 13.9 KB Raw History
{
	"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"
				}
			}
		}
	}
}