> ## 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 tasks resource

> Upload, list, download, and remove the task archives in a dataset.

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

## `client.datasets.tasks.put`

Upload a zip archive as a task, replacing any task with the same ID.

```python Signature theme={null}
async def put(
    benchmark: str,
    dataset: str,
    task_id: str,
    archive: str | Path,
) -> DatasetTaskResponse
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

task\_idrequired · str

archiverequired · str | Path

**Returns**

DatasetTaskResponse

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

## `client.datasets.tasks.list`

Fetch one page of tasks; pass next\_cursor back as cursor until it is null.

```python Signature theme={null}
async def list(
    benchmark: str,
    dataset: str,
    *,
    cursor: str | None = None,
    limit: int = 100,
) -> DatasetTasksResponse
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

cursoroptional · str | None · default: `None`

limitoptional · int · default: `100`

**Returns**

DatasetTasksResponse

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

## `client.datasets.tasks.list_all`

Fetch every task in a dataset by following next\_cursor.

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

**Parameters**

benchmarkrequired · str

datasetrequired · str

**Returns**

DatasetTasksResponse

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

## `client.datasets.tasks.get`

Fetch a task's metadata and a short-lived download URL for its archive.

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

**Parameters**

benchmarkrequired · str

datasetrequired · str

task\_idrequired · str

**Returns**

DatasetTaskDownloadResponse

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

## `client.datasets.tasks.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,
    *,
    overwrite: bool = False,
) -> Path
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

task\_idrequired · str

destinationrequired · str | Path

overwriteoptional · bool · default: `False`

**Returns**

Path

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

## `client.datasets.tasks.remove`

Delete a task from a dataset.

```python Signature theme={null}
async def remove(benchmark: str, dataset: str, task_id: str) -> DatasetTaskResponse
```

**Parameters**

benchmarkrequired · str

datasetrequired · str

task\_idrequired · str

**Returns**

DatasetTaskResponse

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.