# Datasets

Ingested data sources: upload, refresh, schema, and lineage.

<!-- -->

## [📄️Read Datasets](/reference/read-datasets.md)

[Cursor-paginated. The wire query parameter is \`exclusiveStartKey\` (what the cURL tab and the parameter table show); the TypeScript SDK takes it as the \`exclusiveStartKey\` option and the Python SDK as the \`exclusive\_start\_key\` keyword — one parameter, spelled per language. Pass the previous page's \`nextKey\` and stop when it comes back \`null\` — or let \`iterAll()\` / \`iter\_all()\` drive the cursor for you (see the SDKs page, 'Pagination').](/reference/read-datasets.md)

## [📄️Create Dataset](/reference/create-dataset.md)

[Create Dataset](/reference/create-dataset.md)

## [📄️Get Datasets Catalog](/reference/get-datasets-catalog.md)

[Iceberg catalog overview for the current account.](/reference/get-datasets-catalog.md)

## [📄️Read Folder Datasets](/reference/read-folder-datasets.md)

[Cursor-paginated. The wire query parameter is \`exclusiveStartKey\` (what the cURL tab and the parameter table show); the TypeScript SDK takes it as the \`exclusiveStartKey\` option and the Python SDK as the \`exclusive\_start\_key\` keyword — one parameter, spelled per language. Pass the previous page's \`nextKey\` and stop when it comes back \`null\` — or let \`iterAll()\` / \`iter\_all()\` drive the cursor for you (see the SDKs page, 'Pagination').](/reference/read-folder-datasets.md)

## [📄️Download Public Dataset](/reference/download-public-dataset.md)

[Create a dataset from a public data source and trigger download](/reference/download-public-dataset.md)

## [📄️Search Public Datasets](/reference/search-public-datasets.md)

[Search for public datasets from a specific source](/reference/search-public-datasets.md)

## [📄️Get Enabled Public Dataset Sources](/reference/get-enabled-public-dataset-sources.md)

[Get list of enabled public dataset sources](/reference/get-enabled-public-dataset-sources.md)

## [📄️Get Public Dataset Suggestions](/reference/get-public-dataset-suggestions.md)

[Get random popular datasets from all providers](/reference/get-public-dataset-suggestions.md)

## [📄️Validate Sql Query](/reference/validate-sql-query.md)

[Validate a SQL query using sqlglot syntax validation, then run with LIMIT 1.](/reference/validate-sql-query.md)

## [📄️Delete Dataset](/reference/delete-dataset.md)

[Delete Dataset](/reference/delete-dataset.md)

## [📄️Read Dataset](/reference/read-dataset.md)

[Read Dataset](/reference/read-dataset.md)

## [📄️Update Dataset](/reference/update-dataset.md)

[Update Dataset](/reference/update-dataset.md)

## [📄️Get Dataset Freshness](/reference/get-dataset-freshness.md)

[HOW OLD ARE THESE NUMBERS — the newest value in the data's own time column.](/reference/get-dataset-freshness.md)

## [📄️Get Dataset Iceberg Metadata](/reference/get-dataset-iceberg-metadata.md)

[Full Iceberg table metadata for a single dataset.](/reference/get-dataset-iceberg-metadata.md)

## [📄️Get Dataset Lineage](/reference/get-dataset-lineage.md)

[Alias of \`GET /v1/lineage?node=dataset:{dataset\_id}\&direction=both\&depth=3\`,](/reference/get-dataset-lineage.md)

## [📄️Mark Dataset Ready](/reference/mark-dataset-ready.md)

[Return a FAILED dataset to READY WITHOUT re-ingesting — for the case where](/reference/mark-dataset-ready.md)

## [📄️Transfer Dataset Ownership](/reference/transfer-dataset-ownership.md)

[Transfer ownership of a dataset to another user. Requires owner or admin role.](/reference/transfer-dataset-ownership.md)

## [📄️Refresh Dataset](/reference/refresh-dataset.md)

[Manually trigger a dataset refresh.](/reference/refresh-dataset.md)

## [📄️Repartition Dataset](/reference/repartition-dataset.md)

[Start an Iceberg-native maintenance (repartition) job for a dataset.](/reference/repartition-dataset.md)

## [📄️Reset Checkpoint](/reference/reset-checkpoint.md)

[Clear the incremental checkpoint, forcing next refresh to fetch all data.](/reference/reset-checkpoint.md)

## [📄️Retry Dataset](/reference/retry-dataset.md)

[Re-run a FAILED dataset's own ingestion (edit permission).](/reference/retry-dataset.md)

## [📄️Retry Public Dataset Download](/reference/retry-public-dataset-download.md)

[\[DEPRECATED — alias kept for one release, remove after \~2026-10-05\]](/reference/retry-public-dataset-download.md)

## [📄️Set Primary Keys](/reference/set-primary-keys.md)

[Set primary keys on an Iceberg dataset and trigger compaction to enforce uniqueness.](/reference/set-primary-keys.md)

## [📄️Create Dataset Upload](/reference/create-dataset-upload.md)

[Create Dataset Upload](/reference/create-dataset-upload.md)

## [📄️Load Dataset Upload](/reference/load-dataset-upload.md)

[Ingest an uploaded file into the dataset — append to its rows, or REPLACE them.](/reference/load-dataset-upload.md)