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

# Submit Inference Feedback

`POST /v1/inferences/{inference_id}/feedback`

## Request

- Base URL: `https://api.pioneer.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pioneer.ai/v1/inferences/{inference_id}/feedback`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/pioneer/apis/brain-api/docs/v1/inferences/:inference_id/feedback/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Changes

- **2026-09-24** `0e5e86e2bae5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pioneer/apis/brain-api/changes/v1/inferences/:inference_id/feedback/post.md)

---

[API](https://skmtc.dev/pioneer/apis/brain-api.md) - [All operations](https://skmtc.dev/pioneer/apis/brain-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pioneer/apis/brain-api/revisions/0e5e86e2bae5?raw)