Notifications
Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.
Notificationnotification
An item in the user's Vritto inbox.
notifications_findNotificationsBySourceFindthrough vritto_findFinds notifications created for a specific module entity, e.g. all reminders attached to one calendar event.
| Field | Type | Description |
|---|---|---|
| source* | object | Module entity this notification originates from. |
| source.moduleId* | string | Module that owns the source entity, e.g. 'calendar'. |
| source.entityId* | string | ID of the entity the notification is about. |
| limit | integer | Max results (default 25). |
notifications_getNotificationFindthrough vritto_findFetches one notification by ID.
| Field | Type | Description |
|---|---|---|
| notificationId* | string | Notification ID. |
notifications_getUnreadNotificationCountFindthrough vritto_findReturns the unread notification count, optionally scoped to specific modules.
| Field | Type | Description |
|---|---|---|
| moduleIds | list of string | Restrict to notifications from these modules (unique, max 10). |
notifications_listNotificationsFindthrough vritto_findLists inbox notifications, newest first, with optional filter, module scoping, and cursor pagination.
| Field | Type | Description |
|---|---|---|
| filter | one of all, unread, reminder, system, archived | Inbox filter. Defaults to all (non-archived). |
| moduleIds | list of string | Restrict to notifications from these modules (unique, max 10). |
| limit | integer | Max results (default 50). |
| cursor | string | Pagination cursor: the nextCursor value from a previous page. |
notifications_createNotificationCreatethrough vritto_createCreates an immediate notification in the user's inbox. Requires a stable idempotencyKey so retries do not duplicate. Use scheduleNotification instead when the user wants a future reminder.
| Field | Type | Description |
|---|---|---|
| notification* | object | Notification to create. scheduledFor is ignored; delivery is immediate. |
| notification.id | string | Explicit notification ID. Usually omitted so one is generated. |
| notification.title* | string | Notification title. |
| notification.body | string | Notification body. |
| notification.category* | one of reminder, update, system, warning, success | Notification category. |
| notification.priority | one of low, normal, high, critical | Notification priority. Defaults to normal. |
| notification.source | object | Module entity this notification originates from. |
| notification.action | object | Optional tap-through action. |
| notification.requestedChannels* | list of one of | Requested delivery channels; unique, 1-3 entries. |
| notification.idempotencyKey* | string | Stable dedupe key. Re-sends with the same key are merged. |
| notification.scheduledFor | string | When to deliver. Omit for immediate delivery. |
| notification.metadata | list of object | Optional string metadata entries, at most 20. The 'intent' key is special: cancelNotificationsBySource's intent filter matches against metadata.intent. |
notifications_archiveNotificationUpdatethrough vritto_updateArchives one notification, removing it from the active inbox.
| Field | Type | Description |
|---|---|---|
| notificationId* | string | Notification ID. |
notifications_markAllNotificationsReadUpdatethrough vritto_updateMarks all unread, non-archived notifications as read (up to 500 at a time).
No input.
notifications_markNotificationReadUpdatethrough vritto_updateMarks one notification as read.
| Field | Type | Description |
|---|---|---|
| notificationId* | string | Notification ID. |
notifications_markNotificationUnreadUpdatethrough vritto_updateMarks one notification as unread.
| Field | Type | Description |
|---|---|---|
| notificationId* | string | Notification ID. |
notifications_snoozeNotificationUpdatethrough vritto_updateSnoozes a notification until a future time and marks it unread so it resurfaces.
| Field | Type | Description |
|---|---|---|
| notificationId* | string | Notification ID. |
| until* | string | Future time when the notification should resurface. |
notifications_cancelNotificationDeletethrough vritto_deleteCancels a notification (including scheduled ones) and archives it. Use only for explicit cancellations.
| Field | Type | Description |
|---|---|---|
| notificationId* | string | Notification ID. |
notifications_cancelNotificationsBySourceDeletethrough vritto_deleteCancels and archives every notification tied to a module entity, optionally narrowed by metadata intent. Use for bulk cleanup when the underlying entity changed.
| Field | Type | Description |
|---|---|---|
| source* | object | Module entity this notification originates from. |
| source.moduleId* | string | Module that owns the source entity, e.g. 'calendar'. |
| source.entityId* | string | ID of the entity the notification is about. |
| intent | string | Only cancel notifications whose metadata.intent matches. |
Kept in the Vritto app
notifications_scheduleNotification: Reaches outside Vritto: another service, a device, or the public web.notifications_rescheduleNotification: Reaches outside Vritto: another service, a device, or the public web.notifications_dispatchMyNotificationsNow: Reaches outside Vritto: another service, a device, or the public web.notifications_registerPushDevice: Reaches outside Vritto: another service, a device, or the public web.notifications_getNotificationPreferences: Changes or reads app-wide settings, which belong in the app.notifications_setModuleNotificationPreference: Changes or reads app-wide settings, which belong in the app.notifications_setModuleNotificationCategoryPreference: Changes or reads app-wide settings, which belong in the app.notifications_ensureNotificationsFoundation: Background upkeep Vritto already runs on its own.notifications_getNotificationDeliverySummary: Background upkeep Vritto already runs on its own.notifications_getPushDeviceStatus: Background upkeep Vritto already runs on its own.notifications_removePushDevice: Background upkeep Vritto already runs on its own.