Inbox
Per-person notifications.
On this page
Updated on January 1, 1970
Privacy and analytics
We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.
Per-person notifications.
Updated on January 1, 1970
Notifications of the caller in this brand, unread first.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/inbox.notifications.list |
| MCP tool | inbox_notifications_list |
| Scope | inbox.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Nödo, Voice, API |
| Status | Planned |
| Widget | list |
Input
{
unreadOnly?: boolean // default false
cursor?: string // ≤ 512 · Opaque cursor from a previous `nextCursor`.
limit?: integer // 1–50 · default 20
}Output
{
items: Array<{
id: string // uuid
title: string
body: string | null
link: string | null
read: boolean
createdAt: string
}>
nextCursor: string | null
}Marks the caller notifications as read; without ids, all of them in this brand.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/inbox.notifications.mark_read |
| MCP tool | inbox_notifications_mark_read |
| Scope | inbox.write |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Nödo, Voice, API |
| Status | Planned |
Input
{
ids?: string[] // ≤ 100 items
}Output
{
ok: true
id?: string
revision?: integer // -9007199254740991–9007199254740991
}