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

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

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

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/api/hyperion/courses/{courseId}/quiz-exercises/refine-all-questions`
- Auth: none declared

## Path parameters

- `courseId` integer, required

## Request body

- QuizQuestionBulkRefinementRequest: Request to refine multiple quiz questions at once using a single user prompt
  - `questions` unknown[], required: The quiz questions to refine
    - unknown
  - `refinementPrompt` string, required: User instructions describing how all questions should be changed

## Response `200`

OK

- QuizQuestionBulkRefinementResponse: Response containing one refinement result per input question, in the same order
  - `refinements` QuizQuestionRefinementResponse[], required: Refinement results, one per input question in the same order
    - 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

## Changes

- **2026-05-15** `322715dc6959`: 1 breaking
  - removed the required property `refinements/items/oneOf[#/components/schemas/QuizQuestionRefinementSuccess]/question` from the response with the `200` status
- **2026-05-02** `039041cdc17b`: 1 breaking, 7 warning, 3 info
  - added `#/components/schemas/QuizQuestionRefinementSuccess, #/components/schemas/QuizQuestionRefinementFailure` to the `refinements/items/` response property `oneOf` list for the response status `200`
  - the `questions/items/explanation` request property's maxLength was set to `2000`
  - the `questions/items/hint` request property's maxLength was set to `2000`
  - the `questions/items/options/items/explanation` request property's maxLength was set to `2000`
  - …7 more
- **2026-04-29** `ac514a8944c6`: 1 info
  - endpoint added
- **2025-06-29** `afd4091eb170`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/ls1intum/apis/artemis-application-server-api/changes/api/hyperion/courses/:courseId/quiz-exercises/refine-all-questions/post.md)

---

[API](https://skmtc.dev/ls1intum/apis/artemis-application-server-api.md) · [All operations](https://skmtc.dev/ls1intum/apis/artemis-application-server-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ls1intum/apis/artemis-application-server-api/revisions/b164e8d296bb?raw)