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

# Task Runs

> Manage task runs within a benchmark run.

Manage individual task runs that track the outcome of each task within a benchmark run.

## Actions

| Action     | Description                            |
| ---------- | -------------------------------------- |
| `list`     | List all task runs for a benchmark run |
| `get`      | Get a task run by ID                   |
| `complete` | Mark a task run as complete            |
| `cancel`   | Cancel a task run                      |

## Parameters

### `list`

| Parameter        | Type   | Required | Description                            |
| ---------------- | ------ | -------- | -------------------------------------- |
| `benchmarkRunId` | string | yes      | Benchmark run ID to list task runs for |

### `get`

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| `id`      | string | yes      | Task run ID |

### `complete`

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| `id`      | string | yes      | Task run ID |

### `cancel`

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| `id`      | string | yes      | Task run ID |

## Examples

### List task runs for a benchmark run

```json theme={null}
{
  "action": "list",
  "benchmarkRunId": "br_xyz789"
}
```

### Get task run details

```json theme={null}
{
  "action": "get",
  "id": "tr_abc123"
}
```

### Complete a task run

```json theme={null}
{
  "action": "complete",
  "id": "tr_abc123"
}
```