Skip to main content

Get Dataset

GET 

/datasets/:dataset_id

Get a single dataset by ID.

refresh_snapshot (default true) reads the dataset's current Iceberg snapshot ID live rather than the value cached on the dataset row at last write, so current_snapshot_id reflects out-of-band table changes (e.g. a row operation that ran without going through this API's own snapshot-sync path). Pass false to skip that extra read when the cached value is good enough — a listing view refreshing many datasets at once, for example. project_id, when supplied, scopes the lookup so a dataset ID that exists but belongs to a different project is reported as not found rather than returned.

Request​

Responses​

Successful Response