List messages in a thread
Returns a page of messages belonging to the specified thread, in thread order.
Path parameters:
- user_id — authenticated user's UUID (must match the caller's user)
- thread_id — opaque thread ID (thr_xxx) or numeric for backwards compatibility
Default expand: body_html,headers — overrideable via the expand query param. Add raw when you need RFC 5322 MIME.
Response fields: identical shape to GET /v1/users/:user_id/messages, so a mailbox UI can switch between list + thread views without reshaping its parser.
Ordering: received_at ASC — earliest message first.
Pagination (cursor-only): default limit 50, max 100. Pass pagination.next_cursor back as ?cursor= to walk forward. has_more=false means the last page.
Request
- Base URL: http://0.0.0.0:3000
- URL: http://0.0.0.0:3000/v1/users/{user_id}/threads/{thread_id}/messages
- Auth: none declared
Path parameters
Query parameters
Number of items to return (1-100, default 50)
Opaque pagination cursor returned as pagination.next_cursor from a prior response. Pass it back unchanged to fetch the next page. Cursors are sort-key bound — a cursor from one endpoint cannot be reused on another.
Comma-separated list of fields to include. Valid options: body_text, body_html, raw, headers
Response
Default Response
Changes
No recorded changes to this operation across all 1 revision of this API.