Back to Mastra

Reference: dataset.getDetails() | Datasets

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

2025-12-181.7 KB
Original Source

dataset.getDetails()

Added in: @mastra/[email protected]

Retrieves the full dataset record from storage, including metadata, schemas, and version information.

Usage example

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

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

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

// Get dataset details
const details = await dataset.getDetails()
console.log(details.name, details.version)

Parameters

This method takes no parameters.

Returns

Returns a Promise<DatasetRecord>. Throws MastraError if the dataset isn't found.

<PropertiesTable content={[ { name: 'id', type: 'string', description: 'Unique identifier of the dataset.', }, { name: 'name', type: 'string', description: 'Display name of the dataset.', }, { name: 'description', type: 'string', isOptional: true, description: 'Description of the dataset.', }, { name: 'metadata', type: 'Record<string, unknown>', isOptional: true, description: 'Arbitrary metadata associated with the dataset.', }, { name: 'inputSchema', type: 'Record<string, unknown>', isOptional: true, description: 'JSON Schema for item inputs.', }, { name: 'groundTruthSchema', type: 'Record<string, unknown>', isOptional: true, description: 'JSON Schema for item ground truths.', }, { name: 'version', type: 'number', description: 'Current version number of the dataset.', }, { name: 'createdAt', type: 'Date', description: 'When the dataset was created.', }, { name: 'updatedAt', type: 'Date', description: 'When the dataset was last updated.', }, ]} />