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

Compare Other Versions

Lexicon Garden

@