Get dataset item by id | Opik Documentation

curl http://localhost:5173/api/v1/private/datasets/items/itemId \
     -H "Content-Type: application/json"

{
  "source": "manual",
  "data": {
    "image_url": "https://example.com/images/sample1.png",
    "label": "cat",
    "metadata": {
      "resolution": "1024x768",
      "format": "png"
    }
  },
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "dataset_item_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "trace_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "span_id": "1c9e6679-7425-40de-944b-e07fc1f90ae7",
  "description": "Image of a domestic cat sitting on a windowsill.",
  "tags": [
    "animal",
    "cat",
    "indoor"
  ],
  "evaluators": [
    {
      "name": "Image Quality Judge",
      "type": "llm_judge",
      "config": {
        "threshold": 0.85,
        "criteria": [
          "sharpness",
          "brightness"
        ]
      }
    }
  ],
  "execution_policy": {
    "runs_per_item": 5,
    "pass_threshold": 3
  },
  "experiment_items": [
    {
      "experiment_id": "2a1b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "dataset_item_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "trace_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "id": "9b2d6f3e-8c4a-4f3a-9a2b-1d2e3f4a5b6c",
      "project_id": "4d5e6f7a-8b9c-0d1e-2f3a-4b5c6d7e8f90",
      "created_at": "2024-01-15T09:30:00Z",
      "last_updated_at": "2024-01-15T09:30:00Z",
      "created_by": "alice@example.com",
      "last_updated_by": "bob@example.com",
      "trace_visibility_mode": "default"
    }
  ],
  "run_summaries_by_experiment": {
    "2a1b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d": {
      "passed_runs": 4,
      "total_runs": 5,
      "status": "passed"
    }
  },
  "dataset_id": "5f6a7b8c-9d0e-1f2a-3b4c-5d6e7f8a9b0c",
  "created_at": "2024-01-15T09:30:00Z",
  "last_updated_at": "2024-01-15T09:30:00Z",
  "created_by": "alice@example.com",
  "last_updated_by": "bob@example.com"
}

Get dataset item by id

Path parameters

itemIdstringRequiredformat: "uuid"

Response

Dataset item resource

sourceenum

Allowed values:

dataobject

idstringformat: "uuid"

Stable item identifier. On write, used as the upsert key. If omitted, a new ID is generated. Remains the same across dataset versions

dataset_item_idstringRead-onlyformat: "uuid"

Deprecated. Always equals 'id'. Retained for backward compatibility and will be removed in a future version

trace_idstringformat: "uuid"

span_idstringformat: "uuid"

descriptionstringformat: "(?s)^\s*(\S.*\S|\S)\s*$"

tagslist of strings

evaluatorslist of objects

execution_policyobjectRead-only

Default execution policy for items in this version

experiment_itemslist of objectsRead-only

run_summaries_by_experimentmap from strings to objectsRead-only

dataset_idstringRead-onlyformat: "uuid"

created_atdatetimeRead-only

last_updated_atdatetimeRead-only

created_bystringRead-only

last_updated_bystringRead-only