> ## 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.

# Get conversation messages

> Retrieves paginated messages from a specific Security Champion conversation



## OpenAPI

````yaml post /project/{projectId}/security-champion/{conversationId}/messages
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/{conversationId}/messages:
    post:
      tags:
        - AI Agent
      summary: Get conversation messages
      description: >-
        Retrieves paginated messages from a specific Security Champion
        conversation
      operationId: AgentController_getConversationMessages
      parameters:
        - name: projectId
          required: true
          in: path
          description: Project unique identifier
          schema:
            format: uuid
            type: string
        - name: conversationId
          required: true
          in: path
          description: Conversation unique identifier
          schema:
            type: string
        - name: limit
          required: false
          in: query
          description: Maximum number of messages to return
          schema:
            type: number
        - name: start
          required: false
          in: query
          description: Pagination start index
          schema:
            type: number
      responses:
        '200':
          description: Conversation messages retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  messages:
                    type: array
                    items:
                      type: object
                      properties:
                        role:
                          type: string
                          enum:
                            - user
                            - assistant
                        content:
                          type: string
                        createdAt:
                          type: string
                          format: date-time
                  total:
                    type: number
        '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
        '404':
          description: Conversation not found
          content:
            application/json:
              schema:
                example:
                  message: Resource not found
                  statusCode: 404
                  timestamp: '2025-02-18T12:31:18.491Z'
                  path: /example/path

````