Skip to main content
List Conversations
Returns a cursor-paginated list of ConversationPreview objects for the acting user. Only active memberships are included. Results are ordered by lastMessageAt descending (conversations with no messages appear last, ordered by createdAt).
A direct conversation stays out of both parties’ lists until it has a visible last message, so an opened-but-never-sent DM is invisible to the other side. If a DM’s only message is later deleted or moderated away, it drops back out of the list and reappears when either party sends again. group and space conversations appear from creation.
To fetch a single conversation in this same shape — one that was paginated out, or just created — use Fetch Conversation Preview. Both endpoints are served by the same query, so the shapes stay identical.

Query Parameters

string
Comma-separated list of conversation types to include. Valid values: direct, group, space. If omitted, all types are returned. Example: types=direct,group
string
The lastMessageAt timestamp of the last item in the previous page. Used for cursor pagination. Omit for the first page.
string
The createdAt timestamp of the last item in the previous page. Required together with cursor when paginating.
number
Number of conversations to return per page. Defaults to 20. Maximum 50.
string
The acting user whose conversations are listed. Service/master keys only — a service key must pass it (there is no implicit session user); an end-user token infers it from the auth token and may not name a different user.

Response

ConversationPreview[]
Array of conversation preview objects. Each item is a Conversation extended with the following fields:
boolean
Whether more conversations exist beyond this page.