REST API — Datasets

Method	Path	What it does
GET	/api/datasets	The workspace’s datasets — summaries only (no records).
POST	/api/datasets	Create a dataset. sha256 and record_count are computed server-side; create_dataset validates the record array.
POST	/api/datasets/capture	Snapshot an attached source into a new dataset.
POST	/api/datasets/import	Import a CSV or JSON file as a dataset.
DELETE	/api/datasets/{dataset_id}	Delete a dataset. Bindings go NULL (configs and suites survive and refuse cleanly on their next run until re-bound).
GET	/api/datasets/{dataset_id}	One dataset with its records. Cross-workspace ids are not found.
PATCH	/api/datasets/{dataset_id}	Rename, re-describe, or replace the records (re-fingerprints). Runs that snapshotted the old fingerprint fail on their next check — the library makes datasets reusable, not mutable under a run.