app.bsky.notification.listNotifications

bsky-lexicons.bsky.social

Schema Diff

+5 -0

From

CID
bafyreicpn2mr6mv...
Indexed At
2026-02-18 17:59 UTC
View this version

To

CID
bafyreigqqfk3gvs...
Indexed At
2026-08-04 14:48 UTC
View this version

Compatibility Analysis

Backward Compatible

Backward compatible. 4 non-breaking changes.

Non-Breaking Changes (4)
  • AddedVertex AddedVertex { vertex_id: "app.bsky.graph.defs#starterPackViewBasic" }
  • AddedVertex AddedVertex { vertex_id: "app.bsky.notification.listNotifications#notification.starterPack" }
  • AddedEdge AddedEdge { src: "app.bsky.notification.listNotifications#notification", tgt: "app.bsky.notification.listNotifications#notification.starterPack", kind: "prop", name: Some("starterPack") }
  • AddedEdge AddedEdge { src: "app.bsky.notification.listNotifications#notification.starterPack", tgt: "app.bsky.graph.defs#starterPackViewBasic", kind: "ref", name: None }

Migration Guidance

Added Elements

  • AddedVertex { vertex_id: "app.bsky.graph.defs#starterPackViewBasic" }
  • AddedVertex { vertex_id: "app.bsky.notification.listNotifications#notification.starterPack" }

Additional Notes

  • Non-breaking: AddedEdge { src: "app.bsky.notification.listNotifications#notification", tgt: "app.bsky.notification.listNotifications#notification.starterPack", kind: "prop", name: Some("starterPack") }
  • Non-breaking: AddedEdge { src: "app.bsky.notification.listNotifications#notification.starterPack", tgt: "app.bsky.graph.defs#starterPackViewBasic", kind: "ref", name: None }
1 1
{
2 2
  "$type": "com.atproto.lexicon.schema",
3 3
  "defs": {
4 4
    "main": {
5 5
      "description": "Enumerate notifications for the requesting account. Requires auth.",
6 6
      "output": {
7 7
        "encoding": "application/json",
8 8
        "schema": {
9 9
          "properties": {
10 10
            "cursor": {
11 11
              "type": "string"
12 12
            },
13 13
            "notifications": {
14 14
              "items": {
15 15
                "ref": "#notification",
16 16
                "type": "ref"
17 17
              },
18 18
              "type": "array"
19 19
            },
20 20
            "priority": {
21 21
              "type": "boolean"
22 22
            },
23 23
            "seenAt": {
24 24
              "format": "datetime",
25 25
              "type": "string"
26 26
            }
27 27
          },
28 28
          "required": [
29 29
            "notifications"
30 30
          ],
31 31
          "type": "object"
32 32
        }
33 33
      },
34 34
      "parameters": {
35 35
        "properties": {
36 36
          "cursor": {
37 37
            "type": "string"
38 38
          },
39 39
          "limit": {
40 40
            "default": 50,
41 41
            "maximum": 100,
42 42
            "minimum": 1,
43 43
            "type": "integer"
44 44
          },
45 45
          "priority": {
46 46
            "type": "boolean"
47 47
          },
48 48
          "reasons": {
49 49
            "description": "Notification reasons to include in response.",
50 50
            "items": {
51 51
              "description": "A reason that matches the reason property of #notification.",
52 52
              "type": "string"
53 53
            },
54 54
            "type": "array"
55 55
          },
56 56
          "seenAt": {
57 57
            "format": "datetime",
58 58
            "type": "string"
59 59
          }
60 60
        },
61 61
        "type": "params"
62 62
      },
63 63
      "type": "query"
64 64
    },
65 65
    "notification": {
66 66
      "properties": {
67 67
        "author": {
68 68
          "ref": "app.bsky.actor.defs#profileView",
69 69
          "type": "ref"
70 70
        },
71 71
        "cid": {
72 72
          "format": "cid",
73 73
          "type": "string"
74 74
        },
75 75
        "indexedAt": {
76 76
          "format": "datetime",
77 77
          "type": "string"
78 78
        },
79 79
        "isRead": {
80 80
          "type": "boolean"
81 81
        },
82 82
        "labels": {
83 83
          "items": {
84 84
            "ref": "com.atproto.label.defs#label",
85 85
            "type": "ref"
86 86
          },
87 87
          "type": "array"
88 88
        },
89 89
        "reason": {
90 90
          "description": "The reason why this notification was delivered - e.g. your post was liked, or you received a new follower.",
91 91
          "knownValues": [
92 92
            "like",
93 93
            "repost",
94 94
            "follow",
95 95
            "mention",
96 96
            "reply",
97 97
            "quote",
98 98
            "starterpack-joined",
99 99
            "verified",
100 100
            "unverified",
101 101
            "like-via-repost",
102 102
            "repost-via-repost",
103 103
            "subscribed-post",
104 104
            "contact-match"
105 105
          ],
106 106
          "type": "string"
107 107
        },
108 108
        "reasonSubject": {
109 109
          "format": "at-uri",
110 110
          "type": "string"
111 111
        },
112 112
        "record": {
113 113
          "type": "unknown"
114 114
        },
115 +
        "starterPack": {
116 +
          "description": "The starter pack associated with this notification. Present when the notification is for a follow originating from a starter pack.",
117 +
          "ref": "app.bsky.graph.defs#starterPackViewBasic",
118 +
          "type": "ref"
119 +
        },
115 120
        "uri": {
116 121
          "format": "at-uri",
117 122
          "type": "string"
118 123
        }
119 124
      },
120 125
      "required": [
121 126
        "uri",
122 127
        "cid",
123 128
        "author",
124 129
        "reason",
125 130
        "record",
126 131
        "isRead",
127 132
        "indexedAt"
128 133
      ],
129 134
      "type": "object"
130 135
    }
131 136
  },
132 137
  "id": "app.bsky.notification.listNotifications",
133 138
  "lexicon": 1
134 139
}

Compare Other Versions

Lexicon Garden

@