app.bsky.notification.listNotifications

bsky-lexicons.bsky.social

Schema Diff

+8 -0

From

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

To

CID
bafyreidt7fkgzaf...
Indexed At
2026-09-21 16:41 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 +
              "description": "Deprecated: this field is no longer populated.",
21 22
              "type": "boolean"
22 23
            },
23 24
            "seenAt": {
24 25
              "format": "datetime",
25 26
              "type": "string"
26 27
            }
27 28
          },
28 29
          "required": [
29 30
            "notifications"
30 31
          ],
31 32
          "type": "object"
32 33
        }
33 34
      },
34 35
      "parameters": {
35 36
        "properties": {
36 37
          "cursor": {
37 38
            "type": "string"
38 39
          },
39 40
          "limit": {
40 41
            "default": 50,
41 42
            "maximum": 100,
42 43
            "minimum": 1,
43 44
            "type": "integer"
44 45
          },
45 46
          "priority": {
47 +
            "description": "Deprecated: this parameter is ignored.",
46 48
            "type": "boolean"
47 49
          },
48 50
          "reasons": {
49 51
            "description": "Notification reasons to include in response.",
50 52
            "items": {
51 53
              "description": "A reason that matches the reason property of #notification.",
52 54
              "type": "string"
53 55
            },
54 56
            "type": "array"
55 57
          },
56 58
          "seenAt": {
59 +
            "description": "Deprecated: this parameter is unsupported and will cause an error.",
57 60
            "format": "datetime",
58 61
            "type": "string"
59 62
          }
60 63
        },
61 64
        "type": "params"
62 65
      },
63 66
      "type": "query"
64 67
    },
65 68
    "notification": {
66 69
      "properties": {
67 70
        "author": {
68 71
          "ref": "app.bsky.actor.defs#profileView",
69 72
          "type": "ref"
70 73
        },
71 74
        "cid": {
72 75
          "format": "cid",
73 76
          "type": "string"
74 77
        },
75 78
        "indexedAt": {
76 79
          "format": "datetime",
77 80
          "type": "string"
78 81
        },
79 82
        "isRead": {
80 83
          "type": "boolean"
81 84
        },
82 85
        "labels": {
83 86
          "items": {
84 87
            "ref": "com.atproto.label.defs#label",
85 88
            "type": "ref"
86 89
          },
87 90
          "type": "array"
88 91
        },
89 92
        "reason": {
90 93
          "description": "The reason why this notification was delivered - e.g. your post was liked, or you received a new follower.",
91 94
          "knownValues": [
92 95
            "like",
93 96
            "repost",
94 97
            "follow",
95 98
            "mention",
96 99
            "reply",
97 100
            "quote",
98 101
            "starterpack-joined",
99 102
            "verified",
100 103
            "unverified",
101 104
            "like-via-repost",
102 105
            "repost-via-repost",
103 106
            "subscribed-post",
104 107
            "contact-match"
105 108
          ],
106 109
          "type": "string"
107 110
        },
108 111
        "reasonSubject": {
109 112
          "format": "at-uri",
110 113
          "type": "string"
111 114
        },
112 115
        "record": {
113 116
          "type": "unknown"
114 117
        },
118 +
        "starterPack": {
119 +
          "description": "The starter pack associated with this notification. Present when the notification is for a follow originating from a starter pack.",
120 +
          "ref": "app.bsky.graph.defs#starterPackViewBasic",
121 +
          "type": "ref"
122 +
        },
115 123
        "uri": {
116 124
          "format": "at-uri",
117 125
          "type": "string"
118 126
        }
119 127
      },
120 128
      "required": [
121 129
        "uri",
122 130
        "cid",
123 131
        "author",
124 132
        "reason",
125 133
        "record",
126 134
        "isRead",
127 135
        "indexedAt"
128 136
      ],
129 137
      "type": "object"
130 138
    }
131 139
  },
132 140
  "id": "app.bsky.notification.listNotifications",
133 141
  "lexicon": 1
134 142
}

Compare Other Versions

Lexicon Garden

@