createDatasetItem
Add or update a dataset item in Langfuse using dataset name. Supports idempotent updates with a custom ID and linking to source trace or observation.
Instructions
Create or upsert a dataset item. Use id parameter for idempotent updates.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"datasetName": "<datasetName>"
},
"name": "createDatasetItem"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| datasetName | Yes | Name of the dataset to add the item to | |
| input | No | The input for this dataset item (any JSON value) | |
| expectedOutput | No | The expected output for evaluation | |
| metadata | No | Additional metadata | |
| sourceTraceId | No | Link to source trace that generated this item | |
| sourceObservationId | No | Link to source observation (requires sourceTraceId) | |
| id | No | Custom ID for idempotent upsert | |
| status | No | Item status (defaults to ACTIVE) |