Apply changes to dataset items | Opik Documentation

curl -X POST http://localhost:5173/api/v1/private/datasets/id/items/changes \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "string",
  "dataset_id": "string",
  "version_hash": "string",
  "tags": [
    "string"
  ],
  "is_latest": true,
  "version_name": "string",
  "items_total": 1,
  "items_added": 1,
  "items_modified": 1,
  "items_deleted": 1,
  "change_description": "string",
  "metadata": {},
  "evaluators": [
    {
      "name": "string",
      "type": "llm_judge",
      "config": {}
    }
  ],
  "execution_policy": {
    "runs_per_item": 1,
    "pass_threshold": 1
  },
  "created_at": "2024-01-15T09:30:00Z",
  "created_by": "string",
  "last_updated_at": "2024-01-15T09:30:00Z",
  "last_updated_by": "string"
}

Apply delta changes (add, edit, delete) to a dataset version with conflict detection.

This endpoint:

Creates a new version with the applied changes
Validates that baseVersion matches the latest version (unless override=true)
Returns 409 Conflict if baseVersion is stale and override is not set

Use override=true query parameter to force version creation even with stale baseVersion.

Apply delta changes (add, edit, delete) to a dataset version with conflict detection. This endpoint: - Creates a new version with the applied changes - Validates that baseVersion matches the latest version (unless override=true) - Returns 409 Conflict if baseVersion is stale and override is not set Use `override=true` query parameter to force version creation even with stale baseVersion.

Path parameters

idstringRequiredformat: "uuid"

Query parameters

overridebooleanOptionalDefaults to false

Request

This endpoint expects an object.

Response

Version created successfully

idstring or nullRead-onlyformat: "uuid"

dataset_idstring or nullRead-onlyformat: "uuid"

version_hashstring or nullRead-only

tagslist of strings or nullRead-only

is_latestboolean or nullRead-only

Indicates whether this is the latest version of the dataset

version_namestring or nullRead-only

Sequential version name formatted as 'v1', 'v2', etc.

items_totalinteger or nullRead-only

Total number of items in this version

items_addedinteger or nullRead-only

Number of items added since last version

items_modifiedinteger or nullRead-only

Number of items modified since last version

items_deletedinteger or nullRead-only

Number of items deleted since last version

change_descriptionstring or nullRead-only

metadatamap from strings to strings or nullRead-only

evaluatorslist of objects or nullRead-only

Default evaluators for items in this version

execution_policyobject or nullRead-only

Default execution policy for items in this version

created_atstring or nullRead-onlyformat: "date-time"

created_bystring or nullRead-only

last_updated_atstring or nullRead-onlyformat: "date-time"

last_updated_bystring or nullRead-only

Path parameters

Query parameters

Request

Response

Errors