v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Returns paginated examples from the dataset. The server embeds the resolved version in the pagination token. Once pagination begins, all subsequent pages are pinned to that version regardless of concurrent mutations.

get/datasets/{datasetId}/examples

Path parameters

datasetIdstring required

The unique identifier of the dataset.

Query parameters

datasetVersionstring

Dataset version identifier. Accepts "DRAFT" or a non-negative integer string representing a published version number.

Version to paginate: "DRAFT" or a version number. Defaults to DRAFT if absent. Only used on the first request; for subsequent pages, the version is extracted from the pagination token.

maxResultsinteger

Maximum number of examples to return per page.

nextTokenstring

The token for the next page of results.

Response

Success

datasetArnstring required

The Amazon Resource Name (ARN) of the dataset.

datasetIdstring required

The unique identifier of the dataset.

datasetVersionstring required

The version returned.

examplesSensitiveJson[] required

Paginated example content. Each element is a JSON object containing at least an <code>exampleId</code> field plus the schema-specific content fields.

nextTokenstring

The token for the next page of results, or null if there are no more results.