---
title: "Update a human review set"
method: PATCH
path: "/v2/human-eval-sets/{id}"
tags: ["Human Review Sets"]
---

# Update a human review set

`PATCH /v2/human-eval-sets/{id}`

## Path parameters

- `id` string, required — The ID of the human review set to retrieve

## 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 updated the 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

> 251 revisions in range; 71 not diffed.

- **2026-08-28** `9642bb8e4f83` — 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-08-27** `c9228554b833` — 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-08-27** `a38e9ab59771` — 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-08-26** `d5a398a9e78d` — 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-08-26** `1f8d6c19ffa2` — 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/:id/patch.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/9642bb8e4f83/schema)