List agent conversations
Paginated list of conversations for the agent (owned and shared-with-me), excluding archived threads.
Path parameters
Agent identifier used to scope the conversation list.
Query parameters
1-based page number. Defaults to 1.
Page size. Defaults to 20; maximum 100.
Preferred sort field. Supported values are createdAt, lastActivityAt, and title.
The current gateway validator preserves legacy behavior: unsupported values are accepted but ignored, and the handler falls back to lastActivityAt.
Preferred sort direction. Supported values are asc and desc.
The current gateway validator preserves legacy behavior: unsupported values are accepted but ignored, and the handler falls back to descending order.
Case-insensitive search term applied to conversation title and messages.content. Maximum length is 1000 characters. HTML/XSS payloads and format specifiers are rejected.
Inclusive lower bound on createdAt. The handler accepts any JavaScript-parseable date string; invalid values return HTTP 400.
Inclusive upper bound on createdAt. The handler accepts any JavaScript-parseable date string; invalid values return HTTP 400.
Optional status filter applied to the sharedWithMeConversations branch of the response. The main conversations list ignores this parameter.
Optional archived flag applied to the sharedWithMeConversations branch before the route-level non-archived guard is enforced. Accepted values are true and false.
Response
Conversation list