Back to Mastra

Reference: dataset.updateItem() | Datasets

docs/src/content/en/reference/datasets/updateItem.mdx

2025-12-181.3 KB
Original Source

dataset.updateItem()

Added in: @mastra/[email protected]

Updates an existing item in the dataset. Only the provided fields are updated. Updating an item creates a new version.

Usage example

typescript
import { Mastra } from '@mastra/core'

const mastra = new Mastra({
  /* storage config */
})

const dataset = await mastra.datasets.get({ id: 'dataset-id' })

const updated = await dataset.updateItem({
  itemId: 'item-id',
  input: { question: 'What is TypeScript?' },
  groundTruth: { answer: 'A typed superset of JavaScript' },
  metadata: { reviewed: true },
})

Parameters

<PropertiesTable content={[ { name: 'itemId', type: 'string', description: 'ID of the item to update.', }, { name: 'input', type: 'unknown', isOptional: true, description: 'Updated input data.', }, { name: 'groundTruth', type: 'unknown', isOptional: true, description: 'Updated ground truth.', }, { name: 'metadata', type: 'Record<string, unknown>', isOptional: true, description: 'Updated metadata.', }, ]} />

Returns

<PropertiesTable content={[ { name: 'result', type: 'Promise<DatasetItem>', description: 'The updated dataset item. See dataset.addItem() for the item shape.', }, ]} />