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

# Evaluation Questions

The Learning Path evaluation questions allow the platform administrator to define an optional list of questions
that direct feedback toward specific aspects of the Learning Path.

## `EvaluationQuestion` API object

Any LP evaluation question is represented by the `EvaluationQuestion` object:

| Property | Type     | Description                                                             |
| :------- | :------- | :---------------------------------------------------------------------- |
| `id`     | `ID`     | Required; contains the unique identified of the LP evaluation question. |
| `text`   | `String` | Required; represents a subject for feedback submission.                 |

## Get the Learning Path evaluation questions

Available evaluation questions at particular Learning Path for the current API user can be retrieved by using `getLearningPathEvaluationQuestions` query,
which returns a list of `EvaluationQuestion` objects:

<CodeGroup>
  ```GraphQL GraphQL theme={null}
  query getLearningPathEvaluationQuestions {
    getLearningPathEvaluationQuestions(lpId: 23) {
      id
      text
    }
  }
  ```

  ```Query Query result theme={null}
  {
    "data": {
      "getLearningPathEvaluationQuestions": [
        {
          "id": "17",
          "label": "How clearly were the AI concepts explained, and how relevant did you find them to your learning goals?"
        },
        {
          "id": "18",
          "label": "How would you rate the balance between course difficulty and pacing?"
        },
        {
          "id": "19",
          "label": "Overall, how satisfied are you with the course?"
        }
      ]
    }
  }
  ```
</CodeGroup>

## Submit evaluation feedback for a specific evaluation question

Using the retrieved information, it is possible to submit feedback on specific questions by referencing the `questionId` in the feedback input:

<CodeGroup>
  ```GraphQL GraphQL theme={null}
  mutation createLearningPathEvaluationSubmission {
    createLearningPathEvaluationSubmission(lpId: 23, submission: {
      "numericRatingFeedback": [
        {
          "questionId": 17,
          "rating": 4
        },
        {
          "questionId": 18,
          "rating": 5
        }
      ],
      "textFeedback": [
        {
          "questionId": 19,
          "text": "It's would be great to also include a topic about data entropy."
        }
      ],
    }) {
      errors
      response {
        id
      }
    }
  }
  ```

  ```Query Query result theme={null}
  {
    "data": {
      "createLearningPathEvaluationSubmission": {
        "errors": [],
        "response": {
          "id": 1509
        }
      }
    }
  }
  ```
</CodeGroup>