---
title: "Partially update dataset item by id"
method: PATCH
path: "/v1/private/datasets/items/{itemId}"
tags: ["Datasets"]
---

# Partially update dataset item by id

`PATCH /v1/private/datasets/items/{itemId}`

Partially update dataset item by id. Only provided fields will be updated.

## Path parameters

- `itemId` string, uuid, required

## Request body

- DatasetItemWrite
  - `id` string, uuid — Stable item identifier. On write, used as the upsert key. If omitted, a new ID is generated. Remains the same across dataset versions
  - `trace_id` string, uuid
  - `span_id` string, uuid
  - `source` 'manual' | 'trace' | 'span' | 'sdk', required
  - `data` JsonNode, required
  - `description` string
  - `tags` string[]
  - `evaluators` EvaluatorItemWrite[]
    - `name` string, required
    - `type` 'llm_judge' | 'code_metric', required
    - `config` JsonNodeWrite, required
  - `execution_policy` ExecutionPolicyWrite
    - `runs_per_item` integer
    - `pass_threshold` integer

## Response `204`

No content

## Other responses

- `404` — Dataset item not found

---

[API](https://skmtc.net/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.net/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/comet-ml/opik-rest-api/versions/4ed2fbc97cc3/schema)