Lexicon Garden

app.zeens.notification.listNotifications

List notifications for the authenticated Zeens user. Merges likes, replies, follows, group-membership and group-photo events from the firehose.

Repository @zeens.app did:plc:pwpuqwge6g7xrjmfbw73uycw namespace authority
Details · query
Kindquery
Authoritynotification.zeens.app
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

actors

requiredstring

Required comma-separated allowlist of author DIDs (the Zeens membership set). Only notifications authored by one of these DIDs are returned, so activity that reached the repo from Bluesky or another atproto client is excluded. An empty list returns nothing.

cursor

string

Pagination cursor (ISO-8601 timestamp of the oldest notification in the previous page).

limit

integer
  • minimum: 1
  • maximum: 100
  • default: 50

recipient

requiredstring · did

DID whose notifications to fetch. The AppView trusts this value; auth is enforced at the SvelteKit layer.

Output

application/json

cursor

string

notifications

requiredarray
itemsref
Reference

seenAt

string · datetime

#actor

object

Properties

avatar

string

did

requiredstring · did

displayName

string

handle

string

#notification

object

Properties

author

requiredref

Who caused the notification (the liker, replier, follower, inviter, etc.).

Reference

extra

unknown

Reason-specific payload (e.g. group DID, role, accept/decline flag).

indexedAt

requiredstring · datetime

isRead

requiredboolean

labels

array
itemsunknown

reason

requiredstring

The type of notification.

  • knownValues: like | reply | follow | article-like | article-reply | comment_like | comment_reply | group-member-added | group-photo-added | group-invite | group-photo-invite | group-photo-invite-accepted

reasonSubject

string · at-uri

For like/reply/article-like: AT-URI of the subject post/article. For group events: AT-URI of the group record.

recordUri

requiredstring · at-uri

Same as uri — present for compatibility with bsky notification shape.

uri

requiredstring · at-uri

AT-URI of the triggering record (the like, reply, follow, groupMember, etc.).

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.