List Versions

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

This endpoint returns an object.

recordslist of objects

The list of Datasets.

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