List org conversations
GET /api/organizations/{org_id}/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
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org_id | path | `string | null` | yes |
search | query | `string | null` | no |
sort_by | query | string | no | Options: created_at, updated_at, llm_model, accumulated_cost, title |
sort_order | query | string | no | Options: desc (default), asc |
execution_status | query | `string[] | null` | no |
sandbox_status | query | `string | null` | no |
time_window | query | `string | null` | no |
page | query | integer | no | — |
per_page | query | integer | no | — |
include_sub_conversations | query | boolean | no | — |
X-Org-Id | header | `string | null` | no |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
items | OrgConversationResponse[] | yes | — |
total_items | integer | no | — |
page | integer | no | — |
per_page | integer | no | — |
total_pages | integer | no | — |
pagination_accurate | boolean | no | — |
Operation ID: list_org_conversations_api_organizations__org_id__conversations_get