List Versions of a Dataset

GET

Get a list of the versions for a Dataset.

idstringRequired

Unique identifier for Dataset.

statusenumOptional

Filter versions by status: ‘uncommitted’, ‘committed’. If no status is provided, all versions are returned.

Allowed values: uncommittedcommitteddeleted

include_datapoints"latest_committed"OptionalDefaults to latest_committed

If set to ‘latest_committed’, include the Datapoints for the latest committed version. Defaults to None.

Successful Response

recordslist of objects

The list of Datasets.

1	{
2	"records": [
3	{
4	"path": "test-questions",
5	"id": "ds_345mno",
6	"name": "test-questions",
7	"version_id": "dsv_678pqr",
8	"created_at": "2024-05-01T12:00:00Z",
9	"updated_at": "2024-05-01T12:00:00Z",
10	"status": "committed",
11	"last_used_at": "2024-05-01T12:00:00Z",
12	"datapoints_count": 2,
13	"type": "dataset",
14	"created_by": {
15	"id": "usr_v23rSVAgas2a",
16	"full_name": "Jordan Burges",
17	"email_address": "jordan@humanloop.com"
18	},
19	"commit_message": "initial commit"
20	}
21	]
22	}

1	curl -G https://api.humanloop.com/v5/datasets/ds_b0baF1ca7652/versions \
2	-H "X-API-KEY: <apiKey>" \
3	-d status=committed