Notifications
Every Notifications tool, with the scope it needs, its arguments and the API operation it calls.
12 tools
Archive notifications
Changes dataatlas_notifications_archive
Archive one notification without deleting its audit history.
- Scope
inbox:write- Calls
- POST /notifications/{x}/archive
- Example prompt
- Archive notification ntf_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Notification id. |
Get notification digest
Read onlyatlas_notifications_digest_get
Get the current notification digest summary used by the bell and inbox side panel.
- Scope
inbox:read- Calls
- GET /notifications/digest
- Example prompt
- Summarize my notification digest right now.
Arguments
This tool takes no arguments.
List notifications
Read onlyatlas_notifications_list
List caller-scoped in-app notifications with status, kind, project, actor, text, time-window, cursor, and limit filters.
- Scope
inbox:read- Calls
- GET /notifications
- Example prompt
- Show my unread notifications from the Mobile launch project.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
unreadOnly | boolean | No | Backward-compatible unread-only filter. |
status | "unread" | "read" | "archived" | "all" | "everything" | No | |
kinds | array of string | No | |
projectId | string | No | |
actorId | string | No | |
q | string | No | |
since | string (date-time) | No | |
before | string (date-time) | No | |
cursor | string | No | |
limit | integer | No |
Get notification preferences
Read onlyatlas_notifications_preferences_get
Read the caller-scoped notification preferences: per-kind policy, channel toggles, digest cadence, and quiet hours.
- Scope
inbox:read- Calls
- GET /notifications/preferences
- Example prompt
- Show my notification settings.
Arguments
This tool takes no arguments.
Update notification preferences
Changes dataatlas_notifications_preferences_update
Patch notification preferences with merge semantics. Omitted fields are left untouched.
- Scope
inbox:write- Calls
- PATCH /notifications/preferences
- Example prompt
- Turn push notifications off but keep in-app notifications on.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
kinds | object | No | |
channels | object | No | |
digest | "instant" | "daily" | No | |
quietHours | object | null | No | |
lastSeenAt | string (date-time) | No |
Archive notification read in bulk
Changes dataatlas_notifications_read_bulk_archive
Archive all notifications that are already read and return the archive count.
- Scope
inbox:write- Calls
- POST /notifications/archive-all-read
- Example prompt
- Archive all notifications I already read.
Arguments
This tool takes no arguments.
Mark notification read in bulk
Changes dataatlas_notifications_read_bulk_mark
Mark every live notification for the caller as read.
- Scope
inbox:write- Calls
- POST /notifications/read-all
- Example prompt
- Mark all my notifications as read.
Arguments
This tool takes no arguments.
Mark notification read
Changes dataatlas_notifications_read_mark
Mark one notification as read and return the updated row.
- Scope
inbox:write- Calls
- POST /notifications/{x}/read
- Example prompt
- Mark notification ntf_123 as read.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Notification id. |
Restore notifications
Changes dataatlas_notifications_restore
Restore an archived notification to the live inbox.
- Scope
inbox:write- Calls
- POST /notifications/{x}/unarchive
- Example prompt
- Unarchive notification ntf_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Notification id. |
Snooze notifications
Changes dataatlas_notifications_snooze
Snooze one notification until a concrete ISO timestamp.
- Scope
inbox:write- Calls
- POST /notifications/{x}/snooze
- Example prompt
- Snooze notification ntf_123 until tomorrow morning.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Notification id. |
until | string (date-time) | Yes | ISO-8601 wake timestamp. |
List notification snooze presets
Read onlyatlas_notifications_snooze_presets_list
List the server-resolved notification snooze presets with concrete future wake timestamps.
- Scope
inbox:read- Calls
- GET /notifications/snooze-presets
- Example prompt
- What snooze options can I use for notifications?
Arguments
This tool takes no arguments.
Mark notification unread
Changes dataatlas_notifications_unread_mark
Mark one notification as unread and return the updated row.
- Scope
inbox:write- Calls
- POST /notifications/{x}/unread
- Example prompt
- Mark notification ntf_123 as unread.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Notification id. |