v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0223257199.4 KB
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.

include_historyboolean

Include full message history in each conversation.

Response

Standard AstrBot success response

status'ok' required
messagestring
{"stackTrail":"components:schemas:SuccessEnvelope:properties:data","oasType":"schema","type":"unknown"}