List Chats
Chats
List chats
Page through your workspace’s text conversations, newest first.
List Chats
Cursor pagination. Pass the response’s
next_cursor back as ?cursor= for the next page;
has_more is false on the last page. Cursors are opaque - don’t parse them.Use
?origin=widget to see only real end-user conversations from your embedded widget, excluding
chat tests run from the Vocily dashboard.Authorizations
Your API key as a Bearer token, e.g. Authorization: Bearer vk_….
Query Parameters
Filter by agent id
Filter by status
Filter by who started it — comma-list of: widget | dashboard. Use it to exclude your own dashboard chat tests, e.g. ?origin=widget. Rows with an unknown origin are excluded when this is set.
started_at >= this datetime
started_at <= this datetime
Opaque cursor from a previous response's next_cursor
Comma-list of heavy fields to include. Currently: transcript
Maximum records to return in one page.
Required range:
1 <= x <= 100Response
Successful Response