---
title: "Submit Inference Feedback"
method: POST
path: "/inferences/{inference_id}/feedback"
tags: ["inference-history"]
---

# Submit Inference Feedback

`POST /inferences/{inference_id}/feedback`

Submit human feedback on a specific inference.

Marks an inference as correct or incorrect. When marking as incorrect,
the expected output must be provided for downstream training data curation.

Args:
    inference_id: The inference record UUID to annotate.
    request: Feedback payload with verdict, optional corrected output, and notes.
    auth: Authentication result with user_id.

Returns:
    InferenceFeedbackResponse confirming the stored feedback.

Raises:
    HTTPException: 404 if inference not found or outside the caller's team.

## Path parameters

- `inference_id` string, required

## Request body

- InferenceFeedbackRequest — Request to submit human feedback on a specific inference. Args: verdict: Human judgment — correct or incorrect. corrected_output: Expected output when verdict is incorrect. notes: Optional free-text notes from the reviewer.
  - `verdict` 'correct' | 'incorrect', required — Human judgment: 'correct' or 'incorrect'
  - `corrected_output` unknown
  - `notes` string, nullable — Optional reviewer notes

## Response `200`

Successful Response

- InferenceFeedbackResponse — Response after submitting human feedback. Args: inference_id: The inference that was annotated. human_verdict: The stored verdict. human_feedback_at: Timestamp of the feedback submission.
  - `inference_id` string, required — Inference ID that was annotated
  - `human_verdict` string, required — Stored human verdict
  - `human_feedback_at` string, date-time, required — When the feedback was submitted

## Other responses

- `404` — Inference not found.
- `422` — Invalid feedback payload.
- `503` — Inference history dependency is temporarily unavailable.

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)