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

# Benchmarks resource

> Async operations for hosted benchmark and task inspection.

Access these methods through `client.benchmarks`.

<h2 id="fetch">
  `client.benchmarks.fetch`
</h2>

Fetch detailed state for one hosted run.

```python Signature theme={null}
async def fetch(run_id: UUID) -> SingleBenchmarkResponse
```

**Parameters**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"run_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · UUID</span></div>
</div>

**Returns**

<a href="/reference/sdk/models/benchmarks#single-benchmark-response"><code>SingleBenchmarkResponse</code></a>

For examples, see the [Python SDK guide](/sdk/resources).

<h2 id="statuses">
  `client.benchmarks.statuses`
</h2>

Fetch lightweight status and task counts for several runs.

```python Signature theme={null}
async def statuses(run_ids: Sequence[UUID]) -> BenchmarkStatusResponse
```

**Parameters**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"run_ids"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · Sequence\[UUID]</span></div>
</div>

**Returns**

<a href="/reference/sdk/models/benchmarks#benchmark-status-response"><code>BenchmarkStatusResponse</code></a>

For examples, see the [Python SDK guide](/sdk/resources).

<h2 id="tasks">
  `client.benchmarks.tasks`
</h2>

Fetch a filtered and paginated page of tasks for one run.

```python Signature theme={null}
async def tasks(run_id: UUID, request: FetchTasksRequest | None = None) -> TasksResponse
```

**Parameters**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"run_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · UUID</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"request"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · <a href="/reference/sdk/models/benchmarks#fetch-tasks-request"><code>FetchTasksRequest</code></a> | None · default: <code>{"None"}</code></span></div>
</div>

**Returns**

<a href="/reference/sdk/models/benchmarks#tasks-response"><code>TasksResponse</code></a>

For examples, see the [Python SDK guide](/sdk/resources).

<h2 id="task">
  `client.benchmarks.task`
</h2>

Fetch detailed state and evaluation output for one task.

```python Signature theme={null}
async def task(run_id: UUID, task_id: str) -> SingleTaskResponse
```

**Parameters**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"run_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · UUID</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"task_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str</span></div>
</div>

**Returns**

<a href="/reference/sdk/models/benchmarks#single-task-response"><code>SingleTaskResponse</code></a>

For examples, see the [Python SDK guide](/sdk/resources).

<h2 id="artifacts">
  `client.benchmarks.artifacts`
</h2>

Fetch temporary output and log links for one task.

```python Signature theme={null}
async def artifacts(run_id: UUID, task_id: str) -> TaskArtifactsResponse
```

**Parameters**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"run_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · UUID</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"task_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str</span></div>
</div>

**Returns**

<a href="/reference/sdk/models/benchmarks#task-artifacts-response"><code>TaskArtifactsResponse</code></a>

For examples, see the [Python SDK guide](/sdk/resources).