---
title: "Create a human review set"
method: POST
path: "/v2/human-eval-sets"
tags: ["Human Review Sets"]
---

# Create a human review set

`POST /v2/human-eval-sets`

## Request body

- union
  - object
    - `display_name` string, required — Display name of the human review set
    - `description` string — Detailed description of the human review set
    - `human_eval_ids` string[], required — Array of human review IDs to be applied to matching spans
    - `project_id` union — Optional project ID to scope this human review set to a specific project
      - string
      - string, ulid — The id of the resource
    - `filter_type` 'span_type', required
    - `filter_values` string[], required — Array of span types to match
  - object
    - `display_name` string, required — Display name of the human review set
    - `description` string — Detailed description of the human review set
    - `human_eval_ids` string[], required — Array of human review IDs to be applied to matching spans
    - `project_id` union — Optional project ID to scope this human review set to a specific project
      - string
      - string, ulid — The id of the resource
    - `filter_type` 'name', required
    - `filter_value` string, required — Name pattern to match

## Response `200`

Successfully created a human review set

- union
  - object
    - `_id` string, ulid, required — The id of the resource
    - `display_name` string, required — Display name of the human review set
    - `description` string — Detailed description of the human review set
    - `human_eval_ids` string[], required — Array of human review IDs to be applied to matching spans
    - `workspace_id` string, required
    - `project_id` union — Optional project ID to scope this human review set to a specific project
      - string
      - string, ulid — The id of the resource
    - `created_by_id` string
    - `updated_by_id` string
    - `created` union — The date and time the resource was created
      - string, date-time
      - string, date-time
    - `updated` union — The date and time the resource was last updated
      - string, date-time
      - string, date-time
    - `filter_type` 'span_type', required
    - `filter_values` string[], required — Array of span types to match
  - object
    - `_id` string, ulid, required — The id of the resource
    - `display_name` string, required — Display name of the human review set
    - `description` string — Detailed description of the human review set
    - `human_eval_ids` string[], required — Array of human review IDs to be applied to matching spans
    - `workspace_id` string, required
    - `project_id` union — Optional project ID to scope this human review set to a specific project
      - string
      - string, ulid — The id of the resource
    - `created_by_id` string
    - `updated_by_id` string
    - `created` union — The date and time the resource was created
      - string, date-time
      - string, date-time
    - `updated` union — The date and time the resource was last updated
      - string, date-time
      - string, date-time
    - `filter_type` 'name', required
    - `filter_value` string, required — Name pattern to match

## Changes

> 261 revisions in range; 73 not diffed.

- **2026-09-02** `c4473310c013` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the response body `oneOf` list for the response status `200`
- **2026-09-02** `cb6c448ef637` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the response body `oneOf` list for the response status `200`
- **2026-09-01** `359a7831a2f0` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the response body `oneOf` list for the response status `200`
- **2026-09-01** `66b8a4902911` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the response body `oneOf` list for the response status `200`
- **2026-09-01** `081200e02fe0` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the response body `oneOf` list for the response status `200`

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/human-eval-sets/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/4a39391f62da/schema)