---
title: "POST /api/ai/generate-refinement-suggestions/{note}"
method: POST
path: "/api/ai/generate-refinement-suggestions/{note}"
tags: ["ai-controller"]
---

# POST /api/ai/generate-refinement-suggestions/{note}

`POST /api/ai/generate-refinement-suggestions/{note}`

## Path parameters

- `note` integer, required

## Request body

- NoteRefinementQuestionContextDTO
  - `stem` string — MCQ question stem (markdown allowed)
  - `choices` string[] — MCQ response choices (markdown allowed)
  - `correctAnswerIndex` integer — Zero-based index of the correct choice, when known
  - `testedFocus` string — Optional description of what the question was testing

## Response `200`

OK

## Changes

> 145 revisions in range; 13 could not be searched.

- **2026-08-06** `d347d2fc6e5f` — 1 info
  - added optional request body
- **2026-08-06** `555f237630cc` — 1 info
  - added the required property `items/items/ledToQuestion` to the response with the `200` status
- **2026-06-19** `7fe118d81bae` — 1 warning, 1 info
  - removed the optional property `suggestions` from the response with the `200` status
  - added the optional property `items` to the response with the `200` status
- **2026-05-31** `436941a058f6` — 1 info
  - endpoint added
- **2026-05-11** `d7c2946139e9` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nerds-odd-e/apis/openapi-definition/changes/api/ai/generate-refinement-suggestions/:note/post.md)

---

[API](https://skmtc.dev/nerds-odd-e/apis/openapi-definition.md) · [All operations](https://skmtc.dev/nerds-odd-e/apis/openapi-definition/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nerds-odd-e/openapi-definition/revisions/44ef688a3dcd/schema)