List Org Conversations
List all conversations for an organization.
This endpoint returns a paginated list of all conversations within an organization, including details about each conversation such as the creator, timestamps, and metrics.
Access Control: Requires VIEW_ORG_CONVERSATIONS permission (Admin or Owner role).
Args: org_id: Organization UUID search: Search text matching conversation name, creator name, email, or sandbox ID sort_by: Field to sort by (created_at, updated_at, llm_model, accumulated_cost, title) sort_order: Sort order (desc or asc) execution_status: Filter by execution status (idle, running, paused, finished, error, stuck) sandbox_status: Filter by sandbox status (STARTING, RUNNING, PAUSED, ERROR, MISSING) time_window: Time window filter (all, 7d, 30d, 90d) page: Page number (1-indexed) per_page: Items per page (1-100) include_sub_conversations: If True, include sub-conversations in results user_id: Authenticated user ID (injected by require_permission dependency) service: OrgConversationService instance
Returns: OrgConversationPage: Paginated list of conversations with total count
Raises: HTTPException: 401 if user is not authenticated HTTPException: 403 if user lacks VIEW_ORG_CONVERSATIONS permission HTTPException: 500 if retrieval fails
Authorizations
Headers
Path Parameters
Query Parameters
Options: created_at, updated_at, llm_model, accumulated_cost, title
Options: desc (default), asc
Comma-separated list: idle, running, paused, finished, error, stuck
Filter by sandbox status: STARTING, RUNNING, PAUSED, ERROR, MISSING. Note: when filtering by sandbox_status, total_items reflects the unfiltered count since the filter is applied post-query. This may result in pagination showing fewer items per page than expected.
Options: all, 7d, 30d, 90d
x >= 11 <= x <= 100
