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

# Create Feedback

> Create new feedback for a thread.

Supports three types of feedback:
1. Thread-level: Provide only thread_id (feedback on entire conversation)
2. Run-level: Provide thread_id + langsmith_run_id (feedback on specific step)
3. Trace-level: Provide thread_id + langsmith_trace_id (feedback on specific trace)

Requires CREATE permission on ANALYSIS resources.



## OpenAPI

````yaml https://analyst.heyhumm.ai/api/openapi.json post /feedback
openapi: 3.1.0
info:
  title: Analyst API
  description: API for the Analyst service with proper organization-scoped permissions
  version: 1.0.0
servers:
  - url: https://analyst.heyhumm.ai
security: []
paths:
  /feedback:
    post:
      tags:
        - feedback
      summary: Create Feedback
      description: >-
        Create new feedback for a thread.


        Supports three types of feedback:

        1. Thread-level: Provide only thread_id (feedback on entire
        conversation)

        2. Run-level: Provide thread_id + langsmith_run_id (feedback on specific
        step)

        3. Trace-level: Provide thread_id + langsmith_trace_id (feedback on
        specific trace)


        Requires CREATE permission on ANALYSIS resources.
      operationId: create_feedback_feedback_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    FeedbackRequest:
      properties:
        key:
          type: string
          title: Key
          description: >-
            Feedback category key, such as message_helpfulness or
            answer_accuracy.
          examples:
            - message_helpfulness
          example: message_helpfulness
        feedback_type:
          $ref: '#/components/schemas/FeedbackType'
          description: >-
            Feedback input type. Use thumbs_up/thumbs_down for binary sentiment,
            rating for scored feedback, comment for free text, or custom for
            app-specific values.
          examples:
            - thumbs_up
          example: thumbs_up
        score:
          anyOf:
            - type: number
            - type: 'null'
          title: Score
        value:
          anyOf:
            - type: string
            - type: 'null'
          title: Value
        comment:
          anyOf:
            - type: string
            - type: 'null'
          title: Comment
        langsmith_run_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Langsmith Run Id
        langsmith_trace_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Langsmith Trace Id
        thread_id:
          type: string
          title: Thread Id
          description: Thread UUID the feedback applies to.
          examples:
            - 11111111-1111-1111-1111-111111111111
        organization_id:
          type: string
          title: Organization Id
          description: Organization UUID that owns the thread being rated.
          examples:
            - 22222222-2222-2222-2222-222222222222
      type: object
      required:
        - key
        - feedback_type
        - thread_id
        - organization_id
      title: FeedbackRequest
      description: >-
        Request model for creating feedback.


        Required fields:

        - key: Feedback category (e.g., 'helpfulness', 'accuracy')

        - feedback_type: Type of feedback (thumbs_up, thumbs_down, rating,
        comment, custom)

        - thread_id: Thread to provide feedback on

        - organization_id: Organization context
    FeedbackResponse:
      properties:
        key:
          type: string
          title: Key
          description: Feedback key/category (e.g., 'helpfulness', 'accuracy')
        feedback_type:
          $ref: '#/components/schemas/FeedbackType'
          description: Type of feedback
        score:
          anyOf:
            - type: number
            - type: 'null'
          title: Score
          description: Numeric score (0-1 for thumbs, 1-5 for rating)
        value:
          anyOf:
            - type: string
            - type: 'null'
          title: Value
          description: String value for the feedback
        comment:
          anyOf:
            - type: string
            - type: 'null'
          title: Comment
          description: Additional text comment
        langsmith_run_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Langsmith Run Id
          description: LangSmith run ID
        langsmith_trace_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Langsmith Trace Id
          description: LangSmith trace ID
        thread_id:
          type: string
          format: uuid
          title: Thread Id
          description: Internal thread ID
        organization_id:
          type: string
          format: uuid
          title: Organization Id
          description: Organization ID
        user_id:
          type: string
          format: uuid
          title: User Id
          description: User who provided the feedback
        id:
          type: string
          format: uuid
          title: Id
        langsmith_synced:
          type: boolean
          title: Langsmith Synced
        deleted:
          type: boolean
          title: Deleted
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
        - key
        - feedback_type
        - thread_id
        - organization_id
        - user_id
        - id
        - langsmith_synced
        - deleted
        - created_at
        - updated_at
      title: FeedbackResponse
      description: Response model for feedback.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FeedbackType:
      type: string
      enum:
        - thumbs_up
        - thumbs_down
        - rating
        - comment
        - custom
      title: FeedbackType
      description: Types of feedback that can be provided.
    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
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````