Dataset versions resource

Access these methods through client.datasets.versions.

`client.datasets.versions.list`

List the versions of a dataset, newest first, with the tags on each.

Signature

async def list(benchmark: str, dataset: str) -> DatasetVersionsResponse

Parameters

required · str

Returns DatasetVersionsResponse For examples, see the Python SDK guide.

`client.datasets.versions.get`

Get one version of a dataset by revision number, tag, or digest.

Signature

async def get(
    benchmark: str,
    dataset: str,
    ref: str = 'latest',
) -> DatasetVersionDetailResponse

Parameters

required · str

optional · str · default:

Returns DatasetVersionDetailResponse For examples, see the Python SDK guide.

`client.datasets.versions.tasks`

List every task of a dataset version in task ID order, reading one page at a time.

Signature

async def tasks(
    benchmark: str,
    dataset: str,
    ref: str = 'latest',
) -> list[DatasetTaskResponse]

Parameters

required · str

optional · str · default:

Returns list[DatasetTaskResponse] For examples, see the Python SDK guide.

`client.datasets.versions.get_task`

Get one task of a dataset version, with a temporary link to download its archive.

Signature

async def get_task(
    benchmark: str,
    dataset: str,
    task_id: str,
    ref: str = 'latest',
) -> DatasetTaskDownloadResponse

Parameters

required · str

optional · str · default:

Returns DatasetTaskDownloadResponse For examples, see the Python SDK guide.

`client.datasets.versions.tag`

Point a tag at the version ref names. latest always moves. Another tag moves only when force is true.

Signature

async def tag(
    benchmark: str,
    dataset: str,
    tag: str,
    ref: str,
    force: bool = False,
) -> DatasetVersionResponse

Parameters

required · str

optional · bool · default:

Returns DatasetVersionResponse For examples, see the Python SDK guide.

`client.datasets.versions.untag`

Remove a tag from a dataset. The latest tag can’t be removed.

Signature

async def untag(benchmark: str, dataset: str, tag: str) -> DatasetVersionResponse

Parameters

required · str

Returns DatasetVersionResponse For examples, see the Python SDK guide.

`client.datasets.versions.download`

Download a task archive to destination, refusing to replace an existing file unless overwrite is true.

Signature

async def download(
    benchmark: str,
    dataset: str,
    task_id: str,
    destination: str | Path,
    *,
    ref: str = 'latest',
    overwrite: bool = False,
) -> Path

Parameters

required · str

required · str | Path

optional · str · default:

optional · bool · default:

Returns Path For examples, see the Python SDK guide.