Skip to main content
GET

List Conversations

Retrieve a paginated list of conversations in your workspace with optional filtering and search capabilities.

Headers

string
Bearer token for authentication
string
API key for authentication (alternative to Authorization header)
string
Optional. Derived from API Key, but can be specified if you have access to multiple workspaces

Query Parameters

integer
default:"0"
Number of conversations to skip for pagination
integer
default:"100"
Maximum number of conversations to return (1-1000)
string
Filter by conversation status (active, ended, archived)
Search conversations by title
string
Filter conversations by user ID
string
Filter conversations by associated collection ID

Response

array
Array of conversation objects
integer
Total number of conversations matching the filters
Use pagination parameters skip and limit to efficiently navigate through large numbers of conversations. The search parameter performs fuzzy matching on conversation titles.