List all conversations
Retrieve paginated conversations for the authenticated user.
Overview:
Use the optional source query parameter to choose which list to return: owned — only conversations you own (userId matches the current user). shared — conversations where you have recipient access (isShared and your user appears in sharedWith), without the owner-only branch. Defaults to owned when omitted. Each call returns one list; call twice if you need both.
Filtering:
- Only non-archived conversations are returned by default
- Use /conversations/show/archives for archived conversations
Sorting:
Conversations are sorted by last activity timestamp (most recent first) by default.
Query parameters
owned — owner list (userId filter only). shared — explicit share grant list (isShared + sharedWith). Defaults to owned when omitted.
Page number (1-based). Defaults to 1.
Page size. Defaults to 20; capped by the server (max 100).
Sort field. Invalid values fall back to lastActivityAt.
Sort direction. Defaults to desc unless set to asc.
When set, restricts results to that conversation ID (if visible under the chosen source).
Case-insensitive match on title and message content (max 1000 characters).
Filter by createdAt ≥ this ISO date.
Filter by createdAt ≤ this ISO date.
When set, filters by isShared. Accepts case-insensitive true/false, or 1/0.
Response
List of conversations for the requested source