---
title: "POST /v2/feedback/evaluation"
method: POST
path: "/v2/feedback/evaluation"
tags: ["Feedback"]
---

# POST /v2/feedback/evaluation

`POST /v2/feedback/evaluation`

## Request body

- union
  - object
    - `id` string, required — The unique identifier of the human evaluation
    - `evaluation_type` 'human_review', required — The type of evaluation
    - `human_review_id` string — The unique identifier of the human review. Omitted on corrections, which inherit the parent evaluator output schema.
    - `source` 'orq' | 'external'
    - `explanation` string — Optional free-text explanation of the value
    - `reviewed_at` string, date-time — Deprecated. The date and time the item was reviewed
    - `type` 'string', required
    - `value` string, required
    - `trace_id` string, required
  - object
    - `id` string, required — The unique identifier of the human evaluation
    - `evaluation_type` 'human_review', required — The type of evaluation
    - `human_review_id` string — The unique identifier of the human review. Omitted on corrections, which inherit the parent evaluator output schema.
    - `source` 'orq' | 'external'
    - `explanation` string — Optional free-text explanation of the value
    - `reviewed_at` string, date-time — Deprecated. The date and time the item was reviewed
    - `type` 'number', required
    - `value` number, required
    - `trace_id` string, required
  - object
    - `id` string, required — The unique identifier of the human evaluation
    - `evaluation_type` 'human_review', required — The type of evaluation
    - `human_review_id` string — The unique identifier of the human review. Omitted on corrections, which inherit the parent evaluator output schema.
    - `source` 'orq' | 'external'
    - `explanation` string — Optional free-text explanation of the value
    - `reviewed_at` string, date-time — Deprecated. The date and time the item was reviewed
    - `type` 'boolean', required
    - `value` boolean, required
    - `trace_id` string, required
  - object
    - `id` string, required — The unique identifier of the human evaluation
    - `evaluation_type` 'human_review', required — The type of evaluation
    - `human_review_id` string — The unique identifier of the human review. Omitted on corrections, which inherit the parent evaluator output schema.
    - `source` 'orq' | 'external'
    - `explanation` string — Optional free-text explanation of the value
    - `reviewed_at` string, date-time — Deprecated. The date and time the item was reviewed
    - `type` 'string_array', required
    - `values` string[], required
    - `trace_id` string, required

## Response `200`

Event has been dispatched to report the feedback

## Changes

> 255 revisions in range; 71 not diffed.

- **2026-09-01** `081200e02fe0` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the request body `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the request body `oneOf` list
- **2026-08-31** `b22330eb2d5a` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the request body `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the request body `oneOf` list
- **2026-08-31** `94a16765e3fe` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the request body `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the request body `oneOf` list
- **2026-08-31** `3a2f6c296c09` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the request body `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the request body `oneOf` list
- **2026-08-28** `9642bb8e4f83` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the request body `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the request body `oneOf` list

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/feedback/evaluation/post.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/b22330eb2d5a/schema)