> ## Documentation Index > Fetch the complete documentation index at: https://docs.threetone.in/llms.txt > Use this file to discover all available pages before exploring further. # List Workspace Conversation Tickets > List conversation triage tickets across every agent the caller can access, newest first. Filter by status or assignee and use cursor pagination. For one agent's tickets, use the per-agent endpoint. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/convai/triage-tickets openapi: 3.1.0 info: title: Threetone API description: >- APIs for the Threetone Agents Platform and shared workspace resources. Authenticate programmatic requests with an API key in the x-api-key header. version: '1.0' servers: - url: https://api.threetone.in description: Production security: [] paths: /v1/convai/triage-tickets: get: summary: List Workspace Conversation Tickets description: >- List conversation triage tickets across every agent the caller can access, newest first. Filter by status or assignee and use cursor pagination. For one agent's tickets, use the per-agent endpoint. operationId: list_workspace_conversation_tickets_route parameters: - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: How many agent conversation tickets to return. Can not exceed 100. default: 100 title: Page Size description: How many agent conversation tickets to return. Can not exceed 100. - name: status in: query required: false schema: anyOf: - $ref: '#/components/schemas/AgentConversationTicketStatus' - type: 'null' description: Filter tickets by status. title: Status description: Filter tickets by status. - name: assignee_user_id in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Filter tickets by assignee. Use 'unassigned' for tickets with no assignee. title: Assignee User Id description: >- Filter tickets by assignee. Use 'unassigned' for tickets with no assignee. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Used for fetching next page. Cursor is returned in the response. title: Cursor description: Used for fetching next page. Cursor is returned in the response. - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. title: X-Api-Key description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/GetAgentConversationTicketsPageResponseModel '422': description: Validation Error content: application/json: schema: anyOf: - $ref: '#/components/schemas/HTTPValidationError' - $ref: '#/components/schemas/APIErrorResponse' title: Response 422 List Workspace Conversation Tickets Route default: description: >- API error. Depending on the operation: 400 invalid request, 401 authentication required, 402 insufficient credits, 403 permission denied, 404 resource not found, 409 conflict, 429 rate limit, 500 internal failure, 502 upstream failure, 503 service unavailable, or 504 upstream timeout. A failed response does not establish whether a state-changing operation completed; do not retry such operations without checking their outcome. headers: X-Request-Id: description: Request identifier, when available. schema: type: string Retry-After: description: >- When supplied, the delay in seconds or HTTP date before a subsequent request. schema: type: string content: application/json: schema: $ref: '#/components/schemas/APIErrorResponse' components: schemas: AgentConversationTicketStatus: type: string enum: - open - in_progress - resolved - merged title: AgentConversationTicketStatus GetAgentConversationTicketsPageResponseModel: properties: agent_conversation_tickets: items: $ref: '#/components/schemas/AgentConversationTicketResponseModel' type: array title: Agent Conversation Tickets next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor has_more: type: boolean title: Has More type: object required: - agent_conversation_tickets - has_more title: GetAgentConversationTicketsPageResponseModel HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError APIErrorResponse: properties: detail: $ref: '#/components/schemas/APIErrorDetail' type: object required: - detail title: APIErrorResponse AgentConversationTicketResponseModel: properties: agentqa_ticket_id: type: string title: Agentqa Ticket Id workspace_id: type: string title: Workspace Id owner_user_id: type: string title: Owner User Id agent_id: type: string title: Agent Id needs_clustering: type: boolean title: Needs Clustering issue_type: anyOf: - $ref: '#/components/schemas/AgentConversationTicketIssueType' - type: 'null' labels: items: type: string type: array title: Labels conversation_ids: items: type: string type: array title: Conversation Ids first_seen_unix_secs: anyOf: - type: integer - type: 'null' title: First Seen Unix Secs last_seen_unix_secs: anyOf: - type: integer - type: 'null' title: Last Seen Unix Secs qa_comment: anyOf: - type: string - type: 'null' title: Qa Comment ticket_comments: items: $ref: '#/components/schemas/TicketCommentResponseModel' type: array title: Ticket Comments turn_comments: items: $ref: '#/components/schemas/TurnCommentResponseModel' type: array title: Turn Comments status: $ref: '#/components/schemas/AgentConversationTicketStatus' source: $ref: '#/components/schemas/AgentConversationTicketSource' assignee_user_id: anyOf: - type: string - type: 'null' title: Assignee User Id created_at_unix_secs: type: integer title: Created At Unix Secs updated_at_unix_secs: type: integer title: Updated At Unix Secs type: object required: - agentqa_ticket_id - workspace_id - owner_user_id - agent_id - needs_clustering - issue_type - labels - conversation_ids - first_seen_unix_secs - last_seen_unix_secs - qa_comment - ticket_comments - turn_comments - status - source - assignee_user_id - created_at_unix_secs - updated_at_unix_secs title: AgentConversationTicketResponseModel ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError APIErrorDetail: properties: status: type: string title: Status description: >- Stable application error identifier, separate from the HTTP status code. message: type: string title: Message description: Customer-facing explanation of the error. request_id: anyOf: - type: string - type: 'null' title: Request Id description: Request identifier for support and troubleshooting, when available. additionalProperties: true type: object required: - status - message title: APIErrorDetail description: Public error fields; domains may supply additional customer-safe detail. AgentConversationTicketIssueType: type: string enum: - knowledge_gap - incorrect_information - documentation_gap - product_feedback - platform_bug - tool_issue - missing_tool - unnecessary_escalation - wrong_action title: AgentConversationTicketIssueType TicketCommentResponseModel: properties: comment: type: string title: Comment created_at_unix_secs: type: integer title: Created At Unix Secs owner_user_id: anyOf: - type: string - type: 'null' title: Owner User Id type: object required: - comment - created_at_unix_secs - owner_user_id title: TicketCommentResponseModel TurnCommentResponseModel: properties: turn_index: type: integer title: Turn Index comment: type: string title: Comment created_at_unix_secs: type: integer title: Created At Unix Secs owner_user_id: anyOf: - type: string - type: 'null' title: Owner User Id type: object required: - turn_index - comment - created_at_unix_secs - owner_user_id title: TurnCommentResponseModel AgentConversationTicketSource: type: string enum: - qa - agent - manual title: AgentConversationTicketSource ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.