List inbox messages
Returns a paginated page of the caller’s personal in-app inbox messages (agent-delivered notifications such as scheduled-task digests), with each message’s title, body, source and read state, plus the total matching count, the workspace-wide unread count for the nav badge, and the current page and page size. Scoped to the caller’s own inbox; admins do not see other users’ inboxes. Supports an unread-only filter, a case-insensitive free-text search over title, body and schedule name, paging (page and page_size 1-100, default 25), and a sort of recent (default) or oldest.
Authorizations
Personal Access Token. Send as Authorization: Bearer hq_pat_....
Query Parameters
true filters to read_at IS NULL.
Free-text filter: case-insensitive substring over the message title, body, and (for schedule digests) the schedule name.
1-based page index. Clamped to >= 1.
Rows per page. Clamped to 1..=100; defaults to 25.
recent (default, newest delivery first) or oldest.
Back-compat: an old SPA build calls ?limit=. Used as the
page_size fallback so the pre-pagination client still works.
Response
The caller's inbox page
Total rows matching the unread + search filter, before paging.
Unread across the whole inbox (drives the nav badge) - independent of the current page / search / sort.