Conversations
List conversation history data
Required scope: data
get/api/v1/conversations
Query parameters
pageinteger
page_sizeinteger
platform_idstring
user_idstring
searchstring
platformsstring
Comma-separated platform IDs.
message_typesstring
Comma-separated message types.
exclude_idsstring
Comma-separated user IDs to exclude.
exclude_platformsstring
Comma-separated platforms to exclude.
keywordstring
Match conversation titles or message content.
umostring
Match the unified message origin.
sort_by'created_at' | 'updated_at'
sort_order'asc' | 'desc'
group_by_sessionboolean
Paginate by UMO and return all conversation summaries for each selected session.
include_historyboolean
Include full message history in each conversation.
Response
Standard AstrBot success response