For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Copy to LLMGithubGo to App
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
    • Overview
  • Python SDK
    • Reference
    • REST API Client
  • Typescript SDK
    • Overview
    • Opik TS
    • Prompts
    • Opik Query Language (OQL)
  • Rest API
    • Overview
        • POSTApply changes to dataset items
        • PATCHBatch update dataset items
        • GETFind datasets
        • POSTCreate dataset
        • PUTCreate/update dataset items
        • POSTCreate dataset items from CSV file
        • POSTCreate dataset items from spans
        • POSTCreate dataset items from traces
        • GETGet dataset by id
        • PUTUpdate dataset by id
        • DELDelete dataset by id
        • POSTDelete dataset by name
        • POSTDelete dataset items
        • POSTDelete datasets
        • GETDownload dataset export file
        • POSTExpand dataset with synthetic samples
        • GETFind dataset items with experiment items
        • POSTGet dataset by name
        • GETGet experiment items stats for dataset
        • GETGet dataset export job status
        • GETGet all dataset export jobs
        • GETGet dataset item by id
        • PATCHPartially update dataset item by id
        • GETGet dataset items
        • GETGet dataset items output columns
        • PUTMark dataset export job as viewed
        • POSTStart dataset CSV export
        • POSTStream dataset items
        • GETCompare latest version with draft
        • POSTCreate version tag
        • DELDelete version tag
        • GETList dataset versions
        • POSTRestore dataset to a previous version
        • POSTRetrieve dataset version by name
        • PATCHUpdate dataset version
LogoLogo
Copy to LLMGithubGo to App
Rest APIAPI ReferenceDatasets

Partially update dataset item by id

PATCH
/v1/private/datasets/items/:itemId
PATCH
/api/v1/private/datasets/items/:itemId
$curl -X PATCH http://localhost:5173/api/v1/private/datasets/items/itemId \
> -H "Content-Type: application/json" \
> -d '{
> "source": "manual",
> "data": {}
>}'
Partially update dataset item by id. Only provided fields will be updated.
Was this page helpful?
Previous

Get dataset items

Next
Built with

Path parameters

itemIdstringRequiredformat: "uuid"

Request

This endpoint expects an object.
sourceenumRequired
Allowed values:
dataobjectRequired
idstringOptionalformat: "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_idstringOptionalformat: "uuid"
span_idstringOptionalformat: "uuid"
descriptionstringOptionalformat: "(?s)^\s*(\S.*\S|\S)\s*$"
tagslist of stringsOptional
evaluatorslist of objectsOptional
execution_policyobjectOptional

Errors

404
Not Found Error