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

# POST - Create Worksheet Question Configuration

> Finalizes the worksheet metadata by submitting **subject matter** and **learning standards** for a given worksheet.  
This step ensures that the worksheet proceeds to the **question configuration phase**.

**How to Use:**
 1. Call `POST /worksheet/v1/question-config/{work_sheet_id}` with a valid worksheet ID.
 2. Provide the finalized metadata in the request body (`subject_matter` and `learning_standards`).
 3. If successful, the worksheet question configuration process will be initiated asynchronously.
 4. If the worksheet is not found, or if its steps are invalid, a corresponding error is returned.

**Path Parameters:**
- `work_sheet_id` (UUID, required): The unique ID of the worksheet.




## OpenAPI

````yaml POST /worksheet/v1/question-config/{work_sheet_id}
openapi: 3.0.1
info:
  title: Evaluation Report API
  description: An API for retrieving evaluation reports.
  version: 1.0.0
servers:
  - url: https://api-staging.crazygoldfish.com
    description: SandBox endpoint
  - url: https://api.crazygoldfish.com
    description: Prod End Point
security: []
paths:
  /worksheet/v1/question-config/{work_sheet_id}:
    post:
      summary: Create Worksheet Question Configuration
      description: >-
        Finalizes worksheet metadata for a given worksheet by submitting subject
        matter and learning standards. This triggers background processing for
        question configuration.
      operationId: createQuestionConfig
      parameters:
        - name: work_sheet_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the worksheet
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                subject_matter:
                  type: object
                  properties:
                    topics_to_be_covered:
                      type: object
                      properties:
                        topic:
                          type: object
                          properties:
                            ai_recommendations:
                              type: array
                              items:
                                type: string
                            additional_recommendations:
                              type: array
                              items:
                                type: string
                    prerequisite_knowledge:
                      type: object
                      properties:
                        prerequisite:
                          type: object
                          properties:
                            ai_recommendations:
                              type: array
                              items:
                                type: string
                            additional_recommendations:
                              type: array
                              items:
                                type: string
                    key_concepts_and_subconcepts:
                      type: object
                      properties:
                        concepts:
                          type: object
                          properties:
                            ai_recommendations:
                              type: array
                              items:
                                type: string
                            additional_recommendations:
                              type: array
                              items:
                                type: string
                learning_standards:
                  type: object
                  properties:
                    competencies:
                      type: object
                      properties:
                        competency_list:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                              description:
                                type: string
                    learning_outcomes:
                      type: object
                      properties:
                        outcomes:
                          type: object
                          properties:
                            ai_recommendations:
                              type: array
                              items:
                                type: string
                            additional_recommendations:
                              type: array
                              items:
                                type: string
                    smart_learning_objectives:
                      type: object
                      properties:
                        objects:
                          type: object
                          properties:
                            ai_recommendations:
                              type: array
                              items:
                                type: string
                            additional_recommendations:
                              type: array
                              items:
                                type: string
              required:
                - subject_matter
                - learning_standards
            example:
              subject_matter:
                topics_to_be_covered:
                  topic:
                    ai_recommendations:
                      - >-
                        Explain the concept of magnetic poles and their
                        properties with examples.
                      - >-
                        Describe the behavior of a compass needle near a bar
                        magnet and explain why it gets deflected.
                    additional_recommendations:
                      - >-
                        Include an activity-based question related to creating
                        an electromagnet using a solenoid and steel rod.
                prerequisite_knowledge:
                  prerequisite:
                    ai_recommendations:
                      - >-
                        Understand the concept of magnetism including magnetic
                        poles and their properties.
                    additional_recommendations:
                      - Review the concept of magnetic fields and field lines.
                key_concepts_and_subconcepts:
                  concepts:
                    ai_recommendations:
                      - Magnetic Poles and Their Properties
                      - Visualization of Magnetic Field Lines
                    additional_recommendations:
                      - Comparison of attraction and repulsion between poles
              learning_standards:
                competencies:
                  competency_list:
                    - name: C-8.1
                      description: Develops accurate and appropriate models...
                    - name: C-8.2
                      description: Designs and implements a plan for scientific inquiry...
                learning_outcomes:
                  outcomes:
                    ai_recommendations:
                      - >-
                        Relates phenomena with causes and effects (e.g., compass
                        deflection).
                    additional_recommendations:
                      - Draws labeled diagrams of magnetic field lines.
                smart_learning_objectives:
                  objects:
                    ai_recommendations:
                      - >-
                        Students will analyze the deflection of a compass needle
                        (Analyze).
                    additional_recommendations:
                      - >-
                        Students will sketch ray diagrams and magnetic field
                        lines (Apply).
      responses:
        '200':
          description: Worksheet question configuration initiated successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          example: 152764ca-1685-427c-aba7-4b92dcc0d60f
                        msg:
                          type: string
                          example: >-
                            Worksheet question configuration initiated
                            successfully.
              example:
                detail:
                  - id: 152764ca-1685-427c-aba7-4b92dcc0d60f
                    msg: Worksheet question configuration initiated successfully.
        '400':
          description: Bad request due to invalid state or duplicate configuration.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                          example: >-
                            Worksheet question configuration already In
                            Progress.
              example:
                detail:
                  - msg: Worksheet question configuration already In Progress.
        '404':
          description: Worksheet not found or metadata not finalized.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                          example: Worksheet not found.
              example:
                detail:
                  - msg: Worksheet not found.
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                          example: Unexpected server error.
              example:
                detail:
                  - msg: Unexpected server error.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````