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

# Send user feedback

> Send user or agent feedback on IrisGPT AI answers via this API. This feedback helps IrisAgent improve the quality of its responses over time.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/feedback
openapi: 3.0.3
info:
  title: IrisAgent's API Reference
  description: >
    IrisAgent service can be used as an API to power intelligent conversations
    and search, index, and connect with your internal and external knowledge
    articles, tickets, community forums, product documentation,

    and other informational content.
  version: 1.2.0
servers:
  - url: https://api1.irisagent.com
security:
  - bearerAuth: []
paths:
  /v1/feedback:
    post:
      summary: Send user feedback
      description: >-
        Send user or agent feedback on IrisGPT AI answers via this API. This
        feedback helps IrisAgent improve the quality of its responses over time.
      operationId: postFeedback
      parameters:
        - $ref: '#/components/parameters/ChatIdentifier'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackRequest'
      responses:
        '200':
          description: Feedback submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '408':
          $ref: '#/components/responses/408'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        '504':
          $ref: '#/components/responses/504'
components:
  parameters:
    ChatIdentifier:
      name: Chat-Identifier
      in: header
      description: >
        The `Chat-Identifier` is an optional header used to track the
        conversation session.

        If not provided, a new chat session will automatically be created.

        While not required for single request/response interactions, it is
        necessary for maintaining continuity in ongoing conversations.
      required: false
      schema:
        type: string
        format: uuid
  schemas:
    FeedbackRequest:
      type: object
      properties:
        id:
          description: Unique id of the record for whom feedback is being provided.
          type: string
        feedback:
          description: >-
            Feedback on the AI response. It should be either "thumbsUp" or
            "thumbsDown".
          type: string
          enum:
            - thumbsDown
            - thumbsUp
        feedbackDetails:
          description: Optional qualitative feedback.
          type: string
      required:
        - id
        - feedback
    FeedbackResponse:
      type: object
      properties:
        result:
          type: string
          enum:
            - success
      required:
        - result
    Error:
      type: object
      properties:
        error:
          description: Error message
          type: string
        code:
          description: HTTP status code for the error
          type: integer
        status:
          description: Status text corresponding to the error
          type: string
      required:
        - error
        - code
        - status
  responses:
    '400':
      description: >-
        Bad Request - The server cannot process the request due to client error.
        This includes missing required fields, invalid data types, malformed
        JSON, or requests exceeding size limits.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '401':
      description: >-
        Unauthorized - Authentication is required and has failed or has not been
        provided. Your API key may be invalid or missing.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '408':
      description: >-
        Request Timeout - The server timed out waiting for the request to
        complete. The request may be retried.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '429':
      description: >-
        Too Many Requests - You have sent too many requests in a given amount of
        time.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '500':
      description: >-
        Internal Server Error - The server encountered an unexpected condition
        that prevented it from fulfilling the request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '504':
      description: >-
        Gateway Timeout - The server, while acting as a gateway or proxy, did
        not receive a timely response from an upstream server.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |
        The `Authorization` header is required to authenticate API requests.
        It should contain a bearer token obtained through the IrisAgent portal.

````