---
title: "Export refinement-layout AI request JSON"
method: POST
path: "/api/ai/export-refinement-layout-request/{note}"
tags: ["ai-controller"]
---

# Export refinement-layout AI request JSON

`POST /api/ai/export-refinement-layout-request/{note}`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/ai/export-refinement-layout-request/{note}`
- Auth: none declared

Returns the OpenAI structured-response request body for note refinement layout generation (breakdown) without calling OpenAI. Optional MCQ question context uses the same question-aware instruction builder as generate-refinement-suggestions.

## 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
  - `selectedChoiceIndex` integer: Zero-based index of the learner's selected choice, when known
  - `clarification` string: Optional clarification explicitly reviewed by the learner
  - `testedFocus` string: Optional description of what the question was testing

## Response `200`

OK

- object

## Changes

- **2026-10-14** `ca6161933dfa`: 2 info
  - added the new optional request property `clarification`
  - added the new optional request property `selectedChoiceIndex`
- **2026-10-14** `a6b4ea16d54a`: 2 warning
  - removed the request property `clarification`
  - removed the request property `selectedChoiceIndex`
- **2026-10-14** `ca6161933dfa`: 2 info
  - added the new optional request property `clarification`
  - added the new optional request property `selectedChoiceIndex`
- **2026-10-14** `a6b4ea16d54a`: 2 warning
  - removed the request property `clarification`
  - removed the request property `selectedChoiceIndex`
- **2026-10-12** `537808f89c3d`: 2 info
  - added the new optional request property `clarification`
  - added the new optional request property `selectedChoiceIndex`

[Operation history](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/changes/api/ai/export-refinement-layout-request/:note/post.md)

---

[API](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api.md) - [All operations](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/revisions/193c5e89085a?raw)