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

# Create lesson feedback

> Creates a new feedback for a lesson



## OpenAPI

````yaml /openapi/beyond-ai/qti-api.yaml post /lesson
openapi: 3.1.0
info:
  title: QTI API
  version: 1.0.0
  description: >-
    A robust assessment engine implementing the QTI 3.0 specification, designed
    for creating, managing, and delivering educational assessments.
servers:
  - url: https://qti.alpha-1edtech.ai/api
    description: Main Server
security:
  - OAuth2: []
  - MCP: []
tags:
  - name: Validation
    description: >-
      Validate XML strings against QTI compliant XSD files. XSD version
      supported is 3.0.0 (3p0)
  - name: Feedback
    description: Feedback for questions and lessons
  - name: Assessment Test Management
    description: >-
      Enables the management of Assessment Tests. Assessment Tests are the main
      entities that contain Assessment Test Parts, Sections, and Assessment
      Items.
  - name: Test Part Management
    description: >-
      Enables the management of Test Parts. Assessment Test Parts are used to
      group sections inside of an Assessment Test.
  - name: Section Management
    description: >-
      Enables the management of Sections. Assessment Sections are used to group
      Assessment Items.
  - name: Assessment Item Management
    description: >-
      Enables the management of Assessment ITems. Assessment Items are made up
      of QTI Interactions (e.g. questions, multiple choice, etc.).
  - name: Stimulus Management
    description: >-
      Enables the management of Stimuli. Stimuli are shared content pieces
      (text, images, audio, video) that provide context for assessment items and
      can be referenced by multiple questions.
paths:
  /lesson:
    post:
      tags:
        - Feedback
      summary: Create lesson feedback
      description: Creates a new feedback for a lesson
      operationId: createLessonFeedback
      requestBody:
        description: The lesson feedback content to create
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                questionId:
                  type: string
                  description: >-
                    Identifier of the specific question this feedback refers to
                    (optional, for question-level feedback)
                userId:
                  type: string
                  description: Identifier of the user who submitted the feedback
                feedback:
                  type: string
                  description: The feedback content provided by the user
                lessonId:
                  type: string
                  description: Identifier of the lesson this feedback refers to (required)
                humanApproved:
                  type: boolean
                  description: >-
                    Whether the feedback has been reviewed and approved by a
                    human
              required:
                - userId
                - feedback
                - lessonId
              description: Schema for creating new feedback (identifier is auto-generated)
      responses:
        '201':
          description: Successfully created lesson feedback
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateFeedback'
        '400':
          description: Bad Request - Invalid parameters or validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: High-level error message
                  code:
                    type: string
                    description: Machine code identifying error type
                  details:
                    type: string
                    description: Additional human details
                  meta:
                    type: object
                    properties:
                      issues:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                              description: Parameter name
                            message:
                              type: string
                              description: Validation message
                            code:
                              type: string
                              description: Zod issue code
                          required:
                            - field
                            - message
                            - code
                        description: Array of individual validation errors
                      eventId:
                        type: string
                        description: Sentry event id
                    required:
                      - issues
                    description: Structured metadata from validation layer
                required:
                  - error
                  - code
                  - meta
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error type identifier
                  message:
                    type: string
                    description: Human-readable error message
                  eventId:
                    type: string
                    description: Sentry event ID for error tracking
                  details:
                    type: string
                    description: Stack trace or additional error details
                required:
                  - error
                  - message
                  - details
                description: Internal server error response
components:
  schemas:
    CreateFeedback:
      type: object
      properties:
        questionId:
          type: string
          description: >-
            Identifier of the specific question this feedback refers to
            (optional, for question-level feedback)
        userId:
          type: string
          description: Identifier of the user who submitted the feedback
        feedback:
          type: string
          description: The feedback content provided by the user
        type:
          type: string
          enum:
            - QUESTION
            - LESSON
          description: >-
            Type of feedback - either for a specific question or for the entire
            lesson
        lessonId:
          type: string
          description: Identifier of the lesson this feedback refers to (required)
        humanApproved:
          type: boolean
          description: Whether the feedback has been reviewed and approved by a human
      required:
        - userId
        - feedback
        - type
        - lessonId
      description: Schema for creating new feedback (identifier is auto-generated)
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          scopes:
            https://purl.imsglobal.org/spec/qti/v3/scope/readonly: Read access to QTI
            https://purl.imsglobal.org/spec/qti/v3/scope/createput: Create and update access to QTI
            https://purl.imsglobal.org/spec/qti/v3/scope/delete: Delete access to QTI
          tokenUrl: >-
            https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token
    MCP:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: >-
            https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/authorize
          tokenUrl: >-
            https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token
          scopes:
            https://purl.imsglobal.org/spec/qti/v3/scope/readonly: Read access to QTI

````