full diff

app.bsky.notification.getGroupedNotifications

bsky-lexicons.bsky.social +5 −0

← Back to Compare Lexicon page

From

bafyreierpxcqidgy57zawmtvlh5kg6paj2a3njo5cy3kj46uwkl3jyyfii indexed 2026-10-12 12:47 UTC View this version

bafyreihlp4gpub6pvz7uf7b6qtch3sghv4m5heqzjaxzg5zuxk2qvltwra indexed 2026-10-14 19:55 UTC View this version

Compatibility

backward compatible Backward compatible. 2 non-breaking changes.

Non-breaking changes (2)

AddedVertex AddedVertex { vertex_id: "app.bsky.notification.getGroupedNotifications#subscribedPostItem.parent" }
AddedEdge AddedEdge { src: "app.bsky.notification.getGroupedNotifications#subscribedPostItem", tgt: "app.bsky.notification.getGroupedNotifications#subscribedPostItem.parent", kind: "prop", name: Some("parent") }

Migration guidance

Added

AddedVertex { vertex_id: "app.bsky.notification.getGroupedNotifications#subscribedPostItem.parent" }

Notes

Non-breaking: AddedEdge { src: "app.bsky.notification.getGroupedNotifications#subscribedPostItem", tgt: "app.bsky.notification.getGroupedNotifications#subscribedPostItem.parent", kind: "prop", name: Some("parent") }

Changes

11{

22 "$type": "com.atproto.lexicon.schema",

33 "defs": {

44 "contactMatchNotification": {

55 "description": "A contact of the requesting account joined Bluesky.",

66 "properties": {

77 "actor": {

88 "format": "did",

99 "type": "string"

1010 }

1111 },

1212 "required": [

1313 "actor"

1414 ],

1515 "type": "object"

1616 },

1717 "followBackNotification": {

1818 "description": "An actor followed the requesting account back, possibly via a starter pack.",

1919 "properties": {

2020 "actor": {

2121 "format": "did",

2222 "type": "string"

2323 },

2424 "starterPack": {

2525 "format": "at-uri",

2626 "type": "string"

2727 }

2828 },

2929 "required": [

3030 "actor"

3131 ],

3232 "type": "object"

3333 },

3434 "followGroup": {

3535 "description": "Group of actors who followed the requesting account.",

3636 "properties": {

3737 "items": {

3838 "items": {

3939 "ref": "#followItem",

4040 "type": "ref"

4141 },

4242 "minLength": 1,

4343 "type": "array"

4444 }

4545 },

4646 "required": [

4747 "items"

4848 ],

4949 "type": "object"

5050 },

5151 "followItem": {

5252 "description": "An actor who followed the requesting account, possibly via a starter pack.",

5353 "properties": {

5454 "actor": {

5555 "format": "did",

5656 "type": "string"

5757 },

5858 "starterPack": {

5959 "format": "at-uri",

6060 "type": "string"

6161 }

6262 },

6363 "required": [

6464 "actor"

6565 ],

6666 "type": "object"

6767 },

6868 "generatorLikeGroup": {

6969 "description": "Group of likes by different actors on the same feed generator.",

7070 "properties": {

7171 "generator": {

7272 "format": "at-uri",

7373 "type": "string"

7474 },

7575 "items": {

7676 "items": {

7777 "ref": "#generatorLikeItem",

7878 "type": "ref"

7979 },

8080 "minLength": 1,

8181 "type": "array"

8282 }

8383 },

8484 "required": [

8585 "generator",

8686 "items"

8787 ],

8888 "type": "object"

8989 },

9090 "generatorLikeItem": {

9191 "description": "One actor who liked the feed generator in the group.",

9292 "properties": {

9393 "actor": {

9494 "format": "did",

9595 "type": "string"

9696 }

9797 },

9898 "required": [

9999 "actor"

100100 ],

101101 "type": "object"

102102 },

103103 "group": {

104104

      "description": "Contains common metadata and kind-specific data for a notification group or individual notification.",

105105 "properties": {

106106 "count": {

107107 "minimum": 1,

108108 "type": "integer"

109109 },

110110 "id": {

111111 "maxLength": 256,

112112 "type": "string"

113113 },

114114 "indexedAt": {

115115 "format": "datetime",

116116 "type": "string"

117117 },

118118 "isRead": {

119119 "type": "boolean"

120120 },

121121 "kind": {

122122 "refs": [

123123 "#likeGroup",

124124 "#multiPostLikeGroup",

125125 "#multiPostRepostGroup",

126126 "#multiPostLikeViaRepostGroup",

127127 "#multiPostRepostViaRepostGroup",

128128 "#repostGroup",

129129 "#likeViaRepostGroup",

130130 "#repostViaRepostGroup",

131131 "#followGroup",

132132 "#subscribedPostGroup",

133133 "#generatorLikeGroup",

134134 "#replyNotification",

135135 "#quoteNotification",

136136 "#mentionNotification",

137137 "#followBackNotification",

138138 "#verifiedNotification",

139139 "#unverifiedNotification",

140140 "#starterPackJoinedNotification",

141141 "#contactMatchNotification"

142142 ],

143143 "type": "union"

144144 }

145145 },

146146 "required": [

147147 "id",

148148 "isRead",

149149 "indexedAt",

150150 "count",

151151 "kind"

152152 ],

153153 "type": "object"

154154 },

155155 "likeGroup": {

156156 "description": "Group of likes by different actors on the same post.",

157157 "properties": {

158158 "items": {

159159 "items": {

160160 "ref": "#likeItem",

161161 "type": "ref"

162162 },

163163 "minLength": 1,

164164 "type": "array"

165165 },

166166 "post": {

167167 "format": "at-uri",

168168 "type": "string"

169169 }

170170 },

171171 "required": [

172172 "post",

173173 "items"

174174 ],

175175 "type": "object"

176176 },

177177 "likeItem": {

178178 "description": "One actor who liked the group's post.",

179179 "properties": {

180180 "actor": {

181181 "format": "did",

182182 "type": "string"

183183 }

184184 },

185185 "required": [

186186 "actor"

187187 ],

188188 "type": "object"

189189 },

190190 "likeViaRepostGroup": {

191191 "description": "Group of likes by different actors on the same post via the requesting account's repost.",

192192 "properties": {

193193 "items": {

194194 "items": {

195195 "ref": "#likeViaRepostItem",

196196 "type": "ref"

197197 },

198198 "minLength": 1,

199199 "type": "array"

200200 },

201201 "post": {

202202 "format": "at-uri",

203203 "type": "string"

204204 },

205205 "viaRepost": {

206206 "format": "at-uri",

207207 "type": "string"

208208 }

209209 },

210210 "required": [

211211 "post",

212212 "viaRepost",

213213 "items"

214214 ],

215215 "type": "object"

216216 },

217217 "likeViaRepostItem": {

218218 "description": "One actor who liked the group's post via the requesting account's repost.",

219219 "properties": {

220220 "actor": {

221221 "format": "did",

222222 "type": "string"

223223 }

224224 },

225225 "required": [

226226 "actor"

227227 ],

228228 "type": "object"

229229 },

230230 "main": {

231231

      "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.",

232232 "output": {

233233 "encoding": "application/json",

234234 "schema": {

235235 "properties": {

236236 "cursor": {

237237 "maxLength": 1024,

238238 "type": "string"

239239 },

240240 "groups": {

241241

              "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.",

242242 "items": {

243243 "ref": "#group",

244244 "type": "ref"

245245 },

246246 "type": "array"

247247 },

248248 "relatedViews": {

249249

              "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.",

250250 "items": {

251251 "refs": [

252252 "app.bsky.actor.defs#profileViewBasic",

253253 "app.bsky.feed.defs#blockedPost",

254254 "app.bsky.feed.defs#generatorView",

255255 "app.bsky.feed.defs#notFoundPost",

256256 "app.bsky.feed.defs#postView",

257257 "app.bsky.graph.defs#starterPackViewBasic"

258258 ],

259259 "type": "union"

260260 },

261261 "type": "array"

262262 },

263263 "seenAt": {

264264 "format": "datetime",

265265 "type": "string"

266266 }

267267 },

268268 "required": [

269269 "groups"

270270 ],

271271 "type": "object"

272272 }

273273 },

274274 "parameters": {

275275 "properties": {

276276 "cursor": {

277277 "maxLength": 1024,

278278 "type": "string"

279279 },

280280 "feed": {

281281 "default": "all",

282282

            "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'.",

283283 "knownValues": [

284284 "all",

285285 "people-i-follow",

286286 "conversations",

287287 "followers",

288288 "activity"

289289 ],

290290 "maxLength": 32,

291291 "type": "string"

292292 },

293293 "limit": {

294294 "default": 30,

295295 "description": "Maximum number of groups to return.",

296296 "maximum": 50,

297297 "minimum": 1,

298298 "type": "integer"

299299 }

300300 },

301301 "type": "params"

302302 },

303303 "type": "query"

304304 },

305305 "mentionNotification": {

306306 "description": "A post mentioning the requesting account.",

307307 "properties": {

308308 "parent": {

309309 "format": "at-uri",

310310 "type": "string"

311311 },

312312 "post": {

313313 "format": "at-uri",

314314 "type": "string"

315315 }

316316 },

317317 "required": [

318318 "post"

319319 ],

320320 "type": "object"

321321 },

322322 "multiPostLikeGroup": {

323323 "description": "Group of likes by the same actor on different posts.",

324324 "properties": {

325325 "actor": {

326326 "format": "did",

327327 "type": "string"

328328 },

329329 "items": {

330330 "items": {

331331 "ref": "#multiPostLikeItem",

332332 "type": "ref"

333333 },

334334 "minLength": 2,

335335 "type": "array"

336336 }

337337 },

338338 "required": [

339339 "actor",

340340 "items"

341341 ],

342342 "type": "object"

343343 },

344344 "multiPostLikeItem": {

345345 "description": "One post which was liked by the group's actor.",

346346 "properties": {

347347 "post": {

348348 "format": "at-uri",

349349 "type": "string"

350350 }

351351 },

352352 "required": [

353353 "post"

354354 ],

355355 "type": "object"

356356 },

357357 "multiPostLikeViaRepostGroup": {

358358 "description": "Group of likes by the same actor on different posts via the requesting account's reposts.",

359359 "properties": {

360360 "actor": {

361361 "format": "did",

362362 "type": "string"

363363 },

364364 "items": {

365365 "items": {

366366 "ref": "#multiPostLikeViaRepostItem",

367367 "type": "ref"

368368 },

369369 "minLength": 2,

370370 "type": "array"

371371 }

372372 },

373373 "required": [

374374 "actor",

375375 "items"

376376 ],

377377 "type": "object"

378378 },

379379 "multiPostLikeViaRepostItem": {

380380 "description": "One post which was liked by the group's actor via the requesting account's repost.",

381381 "properties": {

382382 "post": {

383383 "format": "at-uri",

384384 "type": "string"

385385 },

386386 "viaRepost": {

387387 "format": "at-uri",

388388 "type": "string"

389389 }

390390 },

391391 "required": [

392392 "post",

393393 "viaRepost"

394394 ],

395395 "type": "object"

396396 },

397397 "multiPostRepostGroup": {

398398 "description": "Group of reposts by the same actor of different posts.",

399399 "properties": {

400400 "actor": {

401401 "format": "did",

402402 "type": "string"

403403 },

404404 "items": {

405405 "items": {

406406 "ref": "#multiPostRepostItem",

407407 "type": "ref"

408408 },

409409 "minLength": 2,

410410 "type": "array"

411411 }

412412 },

413413 "required": [

414414 "actor",

415415 "items"

416416 ],

417417 "type": "object"

418418 },

419419 "multiPostRepostItem": {

420420 "description": "One post which was reposted by the group's actor.",

421421 "properties": {

422422 "post": {

423423 "format": "at-uri",

424424 "type": "string"

425425 }

426426 },

427427 "required": [

428428 "post"

429429 ],

430430 "type": "object"

431431 },

432432 "multiPostRepostViaRepostGroup": {

433433 "description": "Group of reposts by the same actor of different posts via the requesting account's reposts.",

434434 "properties": {

435435 "actor": {

436436 "format": "did",

437437 "type": "string"

438438 },

439439 "items": {

440440 "items": {

441441 "ref": "#multiPostRepostViaRepostItem",

442442 "type": "ref"

443443 },

444444 "minLength": 2,

445445 "type": "array"

446446 }

447447 },

448448 "required": [

449449 "actor",

450450 "items"

451451 ],

452452 "type": "object"

453453 },

454454 "multiPostRepostViaRepostItem": {

455455 "description": "One post which was reposted by the group's actor via the requesting account's repost.",

456456 "properties": {

457457 "post": {

458458 "format": "at-uri",

459459 "type": "string"

460460 },

461461 "viaRepost": {

462462 "format": "at-uri",

463463 "type": "string"

464464 }

465465 },

466466 "required": [

467467 "post",

468468 "viaRepost"

469469 ],

470470 "type": "object"

471471 },

472472 "quoteNotification": {

473473 "description": "A post quoting a post by the requesting account.",

474474 "properties": {

475475 "parent": {

476476 "format": "at-uri",

477477 "type": "string"

478478 },

479479 "post": {

480480 "format": "at-uri",

481481 "type": "string"

482482 }

483483 },

484484 "required": [

485485 "post"

486486 ],

487487 "type": "object"

488488 },

489489 "replyNotification": {

490490 "description": "A reply to a post by the requesting account or to a thread they are participating in.",

491491 "properties": {

492492 "parent": {

493493 "format": "at-uri",

494494 "type": "string"

495495 },

496496 "post": {

497497 "format": "at-uri",

498498 "type": "string"

499499 }

500500 },

501501 "required": [

502502 "post",

503503 "parent"

504504 ],

505505 "type": "object"

506506 },

507507 "repostGroup": {

508508 "description": "Group of reposts by different actors of the same post.",

509509 "properties": {

510510 "items": {

511511 "items": {

512512 "ref": "#repostItem",

513513 "type": "ref"

514514 },

515515 "minLength": 1,

516516 "type": "array"

517517 },

518518 "post": {

519519 "format": "at-uri",

520520 "type": "string"

521521 }

522522 },

523523 "required": [

524524 "post",

525525 "items"

526526 ],

527527 "type": "object"

528528 },

529529 "repostItem": {

530530 "description": "One actor who reposted the group's post.",

531531 "properties": {

532532 "actor": {

533533 "format": "did",

534534 "type": "string"

535535 }

536536 },

537537 "required": [

538538 "actor"

539539 ],

540540 "type": "object"

541541 },

542542 "repostViaRepostGroup": {

543543 "description": "Group of reposts by different actors of the same post via the requesting account's repost.",

544544 "properties": {

545545 "items": {

546546 "items": {

547547 "ref": "#repostViaRepostItem",

548548 "type": "ref"

549549 },

550550 "minLength": 1,

551551 "type": "array"

552552 },

553553 "post": {

554554 "format": "at-uri",

555555 "type": "string"

556556 },

557557 "viaRepost": {

558558 "format": "at-uri",

559559 "type": "string"

560560 }

561561 },

562562 "required": [

563563 "post",

564564 "viaRepost",

565565 "items"

566566 ],

567567 "type": "object"

568568 },

569569 "repostViaRepostItem": {

570570 "description": "One actor who reposted the group's post via the requesting account's repost.",

571571 "properties": {

572572 "actor": {

573573 "format": "did",

574574 "type": "string"

575575 }

576576 },

577577 "required": [

578578 "actor"

579579 ],

580580 "type": "object"

581581 },

582582 "starterPackJoinedNotification": {

583583 "description": "An actor joined Bluesky via a starter pack created by the requesting account.",

584584 "properties": {

585585 "actor": {

586586 "format": "did",

587587 "type": "string"

588588 },

589589 "starterPack": {

590590 "format": "at-uri",

591591 "type": "string"

592592 }

593593 },

594594 "required": [

595595 "actor",

596596 "starterPack"

597597 ],

598598 "type": "object"

599599 },

600600 "subscribedPostGroup": {

601601 "description": "Group of new posts by actors the requesting account subscribes to.",

602602 "properties": {

603603 "items": {

604604 "items": {

605605 "ref": "#subscribedPostItem",

606606 "type": "ref"

607607 },

608608 "minLength": 1,

609609 "type": "array"

610610 }

611611 },

612612 "required": [

613613 "items"

614614 ],

615615 "type": "object"

616616 },

617617 "subscribedPostItem": {

618618 "description": "One new post by an actor the requesting account subscribes to.",

619619 "properties": {

620620 "actor": {

621621 "format": "did",

622622 "type": "string"

623623 },

624 "parent": {

625 "description": "The post this one replies to, if it is a reply.",

626 "format": "at-uri",

627 "type": "string"

628 },

624629 "post": {

625630 "format": "at-uri",

626631 "type": "string"

627632 }

628633 },

629634 "required": [

630635 "actor",

631636 "post"

632637 ],

633638 "type": "object"

634639 },

635640 "unverifiedNotification": {

636641 "description": "A verification of the requesting account was removed.",

637642 "properties": {

638643 "actor": {

639644 "format": "did",

640645 "type": "string"

641646 }

642647 },

643648 "required": [

644649 "actor"

645650 ],

646651 "type": "object"

647652 },

648653 "verifiedNotification": {

649654 "description": "An actor verified the requesting account.",

650655 "properties": {

651656 "actor": {

652657 "format": "did",

653658 "type": "string"

654659 }

655660 },

656661 "required": [

657662 "actor"

658663 ],

659664 "type": "object"

660665 }

661666 },

662667 "id": "app.bsky.notification.getGroupedNotifications",

663668 "lexicon": 1