Skip to main content
GET
List inbox messages

Authorizations

Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Query Parameters

unread
boolean | null

true filters to read_at IS NULL.

q
string | null

Free-text filter: case-insensitive substring over the message title, body, and (for schedule digests) the schedule name.

page
integer<int64> | null

1-based page index. Clamped to >= 1.

page_size
integer<int64> | null

Rows per page. Clamped to 1..=100; defaults to 25.

sort
string | null

recent (default, newest delivery first) or oldest.

limit
integer<int64> | null

Back-compat: an old SPA build calls ?limit=. Used as the page_size fallback so the pre-pagination client still works.

Response

200 - application/json

The caller's inbox page

messages
object[]
required
page
integer<int64>
required
page_size
integer<int64>
required
total
integer<int64>
required

Total rows matching the unread + search filter, before paging.

unread_count
integer<int64>
required

Unread across the whole inbox (drives the nav badge) - independent of the current page / search / sort.