List or get conversations
List conversations, newest first, or pass lead_id for one thread.
Query Parameters
Response
Successful Response
- ConversationListResponse
- ConversationThread
Paginated list envelope.
next_cursor is an opaque, AES-256-GCM-encrypted keyset position (see
internal detail): pass it back as the cursor query
param to get the next page. NULL when there are no more rows.
counts carries the aggregate totals that drive the filter chips (per
connected service, per traffic light, unread, escalated) for the tenant's WHOLE
inbox. It is returned on the first page only. The frontend previously
derived these by counting the rows it had already loaded, which meant the
chips silently under-reported everything past the first page.