---
title: "POST /api/hyperion/courses/{courseId}/quiz-exercises/refine-question"
method: POST
path: "/api/hyperion/courses/{courseId}/quiz-exercises/refine-question"
tags: ["hyperion-quiz-question-generation"]
---

# POST /api/hyperion/courses/{courseId}/quiz-exercises/refine-question

`POST /api/hyperion/courses/{courseId}/quiz-exercises/refine-question`

## Path parameters

- `courseId` integer, required

## Request body

- QuizQuestionRefinementRequest — Request to refine an existing quiz question using a user prompt
  - `refinementPrompt` string, required — User instructions describing how the question should be changed

## Response `200`

OK

- union — Discriminated response for a single quiz question refinement, either a success with the refined question or a failure with an error message
  - object — Successful refinement result containing the refined question and an explanation of the changes
    - `reasoning` string, required — Brief explanation of what was changed during refinement
    - `type` 'success', required
  - object — Failed refinement result containing an error message
    - `error` string, required — Error message describing why the refinement failed
    - `type` 'failure', required

---

[API](https://skmtc.net/ls1intum/apis/artemis-application-server-api.md) · [All operations](https://skmtc.net/ls1intum/apis/artemis-application-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ls1intum/artemis-application-server-api/versions/78e4b68b4816/schema)