Skip to content
MSO CloudDocumentation

Notifications

On this page

The in-app inbox, channel configuration and per-organization notification policy.

notifications#

Source: apps/web/src/server/routers/notifications.ts

Procedure Type Access Description
notifications.unreadCount query orgProcedure The bell's badge.
notifications.list query orgProcedure One page of this person's inbox, newest first.
notifications.markRead mutation rateLimitedOrgProcedure Opening one row marks that row read.
notifications.markAllRead mutation rateLimitedOrgProcedure Clear the badge.
notifications.preferences query authedProcedure —
notifications.recentDeliveries query orgProcedure —
notifications.sendTest mutation authedProcedure One message, to the caller's own verified channel, never anyone else's.
notifications.savePreference mutation rateLimitedOrgProcedure Store one cell of the matrix.

notificationSettings#

Source: apps/web/src/server/routers/notification-settings.ts

Procedure Type Access Description
notificationSettings.list query superAdminProcedure Every catalogue type, with its effective policy and its defaults.
notificationSettings.upsert mutation superAdminProcedure —
notificationSettings.reset mutation superAdminProcedure Drop the override and fall back to the shipped default for this type.

notificationChannels#

Source: apps/web/src/server/routers/notification-channels.ts

Procedure Type Access Description
notificationChannels.list query superAdminProcedure —
notificationChannels.save mutation superAdminProcedure —
notificationChannels.generateVapidKeys mutation superAdminProcedure Mint a vapid key pair server-side and store it.
notificationChannels.test mutation superAdminProcedure Send one test message through a channel, to the acting super admin.
notificationChannels.orgMatrix query superAdminProcedure —
notificationChannels.setOrgChannel mutation superAdminProcedure —
notificationChannels.myChannels query orgProcedure —
notificationChannels.registerPushSubscription mutation authedProcedure Store (or refresh) the push subscription this browser just created.
notificationChannels.removePushSubscription mutation authedProcedure Drop this browser's subscription — called on logout and on unsubscribe.
notificationChannels.startTelegramLink mutation authedProcedure Begin a Telegram link: mint a one-time code the user sends to the bot.
notificationChannels.startZaloLink mutation authedProcedure Begin a Zalo link: mint a one-time code the person sends to the oa.
notificationChannels.unlinkChannel mutation authedProcedure —