Skip to main content
GET
List chat sessions matching the supplied filters.

Query Parameters

agent_id
string

Filter to sessions driven by this agent id.

channel
string

Filter to sessions on this channel.

state
string

Lifecycle filter: active (default), final, or all.

updated_after
string<date-time>

Filter to sessions with last_activity after this timestamp.

skip
integer<int32>
default:0

Pagination offset (default 0).

take
integer<int32>
default:20

Page size (default 20, max 200).

Response

Returns paginated list of sessions.

Paginated result of GET /api/v1/chats.

items
object[] | null

Sessions on this page, ordered by LastActivity descending.

total_count
integer<int32>

Total matching sessions across all pages (unfiltered by skip/take).

skip
integer<int32>

Echo of the request skip.

take
integer<int32>

Echo of the request take.