dataset.listItems()

Added in: @mastra/core@1.4.0

Lists items in the dataset. When a version is specified, returns all items at that version. Otherwise, returns paginated items from the latest version.

Usage example

import { Mastra } from "@mastra/core";

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

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

// Paginated list (default: page 0, 20 per page)
const result = await dataset.listItems();

// List with search
const filtered = await dataset.listItems({ search: "TypeScript", page: 0, perPage: 10 });

// List all items at a specific version
const versionedItems = await dataset.listItems({ version: 2 });

Parameters

version?:

number

Dataset version to list items at. When set, returns all items at that version (no pagination).

page?:

number

Page number for pagination. Defaults to `0`.

perPage?:

number

Number of items per page. Defaults to `20`.

search?:

string

Search string to filter items.

Returns

When version is specified:

result:

Promise<DatasetItem[]>

Array of all items at the specified dataset version.

When version is not specified:

result:

Promise<object>

Paginated response.

object

items:

DatasetItem[]

Array of items for the current page.

pagination:

object

Pagination metadata.

object

total:

number

Total number of items.

page:

number

Current page number.

perPage:

number | false

Items per page, or `false` if unpaginated.

hasMore:

boolean

Whether more pages are available.