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

# Benchmarks

> Groups of tasks with criteria.

Benchmarks group [Tasks](/api-reference/resources/tasks) into a test suite. Each benchmark references an [Environment](/api-reference/resources/environments) and defines timeout and concurrency settings. Each task inside a benchmark has [Criteria](/api-reference/resources/criteria) that the [verification engine](/guides/concepts/verification) runs to score task runs.

## Endpoints

| Method   | Endpoint                                                      | Description           |
| -------- | ------------------------------------------------------------- | --------------------- |
| `GET`    | [`/benchmarks`](/api-reference/endpoint/listBenchmarks)       | List benchmarks       |
| `POST`   | [`/benchmarks`](/api-reference/endpoint/createBenchmark)      | Create a benchmark    |
| `GET`    | [`/benchmarks/{id}`](/api-reference/endpoint/getBenchmark)    | Get benchmark details |
| `PATCH`  | [`/benchmarks/{id}`](/api-reference/endpoint/updateBenchmark) | Update a benchmark    |
| `DELETE` | [`/benchmarks/{id}`](/api-reference/endpoint/deleteBenchmark) | Delete a benchmark    |

## Benchmark Object

| Field             | Type           | Description                    |
| ----------------- | -------------- | ------------------------------ |
| `id`              | string         | Unique identifier              |
| `name`            | string         | Benchmark name                 |
| `description`     | string \| null | Optional description           |
| `timeout`         | number         | Max execution time in seconds  |
| `concurrency`     | number         | Max concurrent task executions |
| `organization_id` | string         | Parent organization            |
| `created_at`      | datetime       | Creation timestamp             |
| `updated_at`      | datetime       | Last modification timestamp    |

## SDK Example

```typescript theme={null}
// Create a benchmark
const benchmark = await verial.benchmarks.create({
  name: 'Prior Auth E2E',
  environmentId: 'env_abc123',
  timeout: 300,
  concurrency: 5,
})

// List all benchmarks
const benchmarks = await verial.benchmarks.list()

// Get a specific benchmark
const details = await verial.benchmarks.get({ id: benchmark.id })

// Update
await verial.benchmarks.update({
  id: benchmark.id,
  timeout: 600,
})

// Delete
await verial.benchmarks.delete({ id: benchmark.id })
```