> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cybedefend.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List user conversations

> Retrieves Security Champion conversations for the authenticated user with optional filters and pagination



## OpenAPI

````yaml post /project/{projectId}/security-champion/conversations/list
openapi: 3.0.0
info:
  title: Cybedefend API
  description: >-
    CybeDefend is an advanced API for application security analysis. Key
    features include OAuth 2.0 authentication, user/organization/project
    management, and REBAC-based permissions. It excels in static, dynamic, and
    IaC security analyses (SAST, DAST, IaC, etc.).
  version: '1.0'
  contact: {}
servers:
  - url: https://api-eu.cybedefend.com
    description: EU
  - url: https://api-us.cybedefend.com
    description: US
security: []
tags: []
paths:
  /project/{projectId}/security-champion/conversations/list:
    post:
      tags:
        - AI Agent
      summary: List user conversations
      description: >-
        Retrieves Security Champion conversations for the authenticated user
        with optional filters and pagination
      operationId: AgentController_listUserConversations
      parameters:
        - name: projectId
          required: true
          in: path
          description: Project unique identifier
          schema:
            format: uuid
            type: string
        - name: branch
          required: false
          in: query
          description: Filter by branch name
          schema:
            example: main
            type: string
        - name: search
          required: false
          in: query
          description: Search in conversation title
          schema:
            example: SQL injection
            type: string
        - name: page
          required: false
          in: query
          description: Page number (1-based)
          schema:
            minimum: 1
            default: 1
            type: number
        - name: pageSize
          required: false
          in: query
          description: Number of items per page (default 20, max 100)
          schema:
            minimum: 1
            maximum: 100
            default: 20
            type: number
        - name: sortBy
          required: false
          in: query
          description: 'Sort field: created_at, updated_at, title'
          schema:
            enum:
              - created_at
              - updated_at
              - title
            type: string
        - name: sortOrder
          required: false
          in: query
          description: 'Sort order: asc or desc'
          schema:
            enum:
              - asc
              - desc
            type: string
      responses:
        '200':
          description: Paginated list of conversations retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  conversations:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        title:
                          type: string
                        status:
                          type: string
                        projectIds:
                          type: array
                          items:
                            type: string
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                        totalMessages:
                          type: number
                        branch:
                          type: string
                        repository:
                          type: string
                        vulnerabilityId:
                          type: string
                  total:
                    type: number
                    description: Total count of matching conversations
                  page:
                    type: number
                    description: Current page number
                  pageSize:
                    type: number
                    description: Items per page
                  totalPages:
                    type: number
                    description: Total number of pages
        '401':
          description: Unauthorized - Invalid or missing authentication token
          content:
            application/json:
              schema:
                example:
                  message: Unauthorized
                  statusCode: 401
                  timestamp: '2025-02-18T12:31:18.491Z'
                  path: /example/path
        '403':
          description: Forbidden - Insufficient permissions
          content:
            application/json:
              schema:
                example:
                  message: Forbidden
                  statusCode: 403
                  timestamp: '2025-02-18T12:31:18.491Z'
                  path: /example/path

````