---
title: "Create Correction"
method: POST
path: "/api/domains/{domain_id}/agent-desk/corrections"
tags: ["agent_desk"]
---

# Create Correction

`POST /api/domains/{domain_id}/agent-desk/corrections`

## Request

- Base URL: `https://api-v1.unusual.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-v1.unusual.ai/api/domains/{domain_id}/agent-desk/corrections`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Correct one answer: the owner door. See ``create_correction_impl``.

`get_user` is required rather than incidental: this spends model tokens, and an
unattributed spend on an authenticated surface is not something to leave
possible. Ownership of the TARGET is proved separately, by
`corrections.resolve_targets` — `get_domain` authorises the domain and says
nothing about the ids in the body.

## Path parameters

- `domain_id` string, required

## Headers

- `x-view-as` string, nullable

## Request body

- CorrectionCreate: A customer's critique of one answer. At least one target. Both are allowed and mean "this exchange", which is how an answer page reached through its generating conversation is corrected once rather than twice.
  - `message_id` string, nullable
  - `answer_page_id` string, nullable
  - `comment` string, nullable

## Response `200`

Successful Response

- CorrectionCreateOut: `POST /corrections`'s response: the state, plus what happened to the draft.
  - `review` ReviewOut, required
    - `id` string, required
    - `message_id` string, nullable
    - `answer_page_id` string, nullable
    - `question_text` string, nullable
    - `answer_excerpt` string, nullable
    - `verdict` string, required
    - `comment` string, nullable
    - `source` string, required
    - `created_by` string, nullable
    - `status` string, required
    - `incorporated_version_id` string, nullable
    - `created_at` string, nullable
    - `updated_at` string, nullable
  - `proposal` CorrectionProposalOut: The proposed control-document version a correction produced.
    - `version_id` string, required
    - `version_number` integer, required
    - `kind` string, nullable
    - `status` string, required
    - `source` string, required
    - `change_summary` string, nullable
    - `markdown` string, required
    - `created_at` string, nullable
  - `diff` object, nullable
  - `learning` object, nullable
  - `spam` boolean
  - `incorporated` boolean
  - `drafting` boolean
  - `strategy` object, nullable
  - `applied` object, nullable
  - `applied_versions` object[]
  - `held` object[]
  - `undo_available_until` string, nullable
  - `undone` boolean
  - `enqueued` boolean, required
  - `status` string, required
  - `detail` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/unusual/apis/dashboard-server.md) - [All operations](https://skmtc.dev/unusual/apis/dashboard-server/llms.txt) - [OpenAPI document](https://skmtc.dev/unusual/apis/dashboard-server/revisions/89f716930ead?raw)