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

# Compare Agent Versions

> Compare two versions of an agent for one source

Compare two versions. Each row has the rate for each version, the change, and `significant`. `significant` is `true`, `false` or `null`. `null` means not enough data: a change counts only when each version has at least 30 samples.

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key (scope `agents`)

### Path

**agentId** `string` *required*

The agent `id` (UUID). The agent must be in your workspace and saved at least once

### Query

**source** `string` *required*

`production`, `simulation` or `test`

**version\_a** `integer` *required*

The first version

**version\_b** `integer` *required*

The second version

**from** `integer`

Start of the window, in Unix seconds

**to** `integer`

End of the window, in Unix seconds

## Response

**200 OK**.

```json theme={null}
{
  "version_a": 6, "version_b": 7, "source": "simulation",
  "evals": [{ "name": "task_success", "a": 0.8, "b": 0.9, "delta": 0.1, "significant": null }],
  "latency": {}
}
```

## Errors

| Status | Code | Meaning |
| - | - | - |
| 400 | `VALIDATION_ERROR` | A query value is missing or wrong |
| 403 | `POLICY_DENY` | Your role cannot read agents, or the API key lacks the `agents` scope |
| 404 | `AGENT_NOT_FOUND` | No agent with this ID in your workspace |

## Example

```bash cURL theme={null}
curl "https://api.60db.ai/agents/AGENT_ID/metrics/compare?source=production&version_a=6&version_b=7" \
  -H "Authorization: Bearer your-api-key"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.