> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valkyrie.vals.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Dataset versions resource

> List, tag, and download the published versions of a dataset.

Access these methods through `client.datasets.versions`.

## `client.datasets.versions.list`

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

```python Signature theme={null}
async def list(benchmark: str, dataset: str) -> DatasetVersionsResponse
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

**Returns**

DatasetVersionsResponse

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.datasets.versions.get`

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

```python Signature theme={null}
async def get(
    benchmark: str,
    dataset: str,
    ref: str = 'latest',
) -> DatasetVersionDetailResponse
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

refoptional · str · default: `'latest'`

**Returns**

DatasetVersionDetailResponse

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.datasets.versions.tasks`

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

```python Signature theme={null}
async def tasks(
    benchmark: str,
    dataset: str,
    ref: str = 'latest',
) -> list[DatasetTaskResponse]
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

refoptional · str · default: `'latest'`

**Returns**

list\[DatasetTaskResponse]

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.datasets.versions.get_task`

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

```python Signature theme={null}
async def get_task(
    benchmark: str,
    dataset: str,
    task_id: str,
    ref: str = 'latest',
) -> DatasetTaskDownloadResponse
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

task\_idrequired · str

refoptional · str · default: `'latest'`

**Returns**

DatasetTaskDownloadResponse

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.datasets.versions.tag`

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

```python Signature theme={null}
async def tag(
    benchmark: str,
    dataset: str,
    tag: str,
    ref: str,
    force: bool = False,
) -> DatasetVersionResponse
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

tagrequired · str

refrequired · str

forceoptional · bool · default: `False`

**Returns**

DatasetVersionResponse

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.datasets.versions.untag`

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

```python Signature theme={null}
async def untag(benchmark: str, dataset: str, tag: str) -> DatasetVersionResponse
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

tagrequired · str

**Returns**

DatasetVersionResponse

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.datasets.versions.download`

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

```python Signature theme={null}
async def download(
    benchmark: str,
    dataset: str,
    task_id: str,
    destination: str | Path,
    *,
    ref: str = 'latest',
    overwrite: bool = False,
) -> Path
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

task\_idrequired · str

destinationrequired · str | Path

refoptional · str · default: `'latest'`

overwriteoptional · bool · default: `False`

**Returns**

Path

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.