> ## 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.

# Tasks

> Manage benchmark tasks.

Manage individual tasks within a benchmark that define what your agent should accomplish.

## Actions

| Action   | Description                   |
| -------- | ----------------------------- |
| `list`   | List all tasks in a benchmark |
| `create` | Create a new task             |
| `get`    | Get a task by ID              |
| `update` | Update a task                 |
| `delete` | Delete a task                 |

## Parameters

### `list`

| Parameter     | Type   | Required | Description                    |
| ------------- | ------ | -------- | ------------------------------ |
| `benchmarkId` | string | yes      | Benchmark ID to list tasks for |

### `create`

| Parameter     | Type      | Required | Description                                             |
| ------------- | --------- | -------- | ------------------------------------------------------- |
| `benchmarkId` | string    | yes      | Benchmark ID to add the task to                         |
| `name`        | string    | yes      | Name of the task                                        |
| `timeout`     | number    | no       | Task-specific timeout in seconds                        |
| `taskItem`    | object    | no       | Task item configuration (patient, instruction, trigger) |
| `scenario`    | object    | no       | Scenario configuration for the task                     |
| `tags`        | string\[] | no       | Tags for filtering and grouping                         |

### `get`

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

### `update`

| Parameter  | Type           | Required | Description                         |
| ---------- | -------------- | -------- | ----------------------------------- |
| `id`       | string         | yes      | Task ID                             |
| `name`     | string         | no       | Updated name                        |
| `timeout`  | number \| null | no       | Updated timeout, or null to clear   |
| `taskItem` | object \| null | no       | Updated task item, or null to clear |
| `scenario` | object \| null | no       | Updated scenario, or null to clear  |
| `tags`     | string\[]      | no       | Updated tags                        |

### `delete`

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

## Examples

### Create a prior auth submission task

```json theme={null}
{
  "action": "create",
  "benchmarkId": "bm_abc123",
  "name": "Submit prior auth for MRI",
  "timeout": 120,
  "taskItem": {
    "patient": "Maria Chen",
    "instruction": "Submit a prior authorization request for a lumbar MRI"
  },
  "tags": ["prior-auth", "imaging"]
}
```

### List tasks in a benchmark

```json theme={null}
{
  "action": "list",
  "benchmarkId": "bm_abc123"
}
```

### Update task tags

```json theme={null}
{
  "action": "update",
  "id": "task_xyz789",
  "tags": ["prior-auth", "imaging", "urgent"]
}
```