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

# Run Golden Eval

> Measure how closely a Judge eval agrees with its golden answers

> [!NOTE]
>
> AI Simulation needs an active **Pro** or **Business** plan. On another plan, every simulation endpoint returns `403 POLICY_DENY`.

Run a Judge eval against its golden set. This makes **one paid Judge request for each example**. A rate limit of 3 starts a minute applies.

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

**name** `string` *required*

The eval name, for example `task_success`. Letters, digits, `_` and `-` only

## Response

**200 OK**.

```json theme={null}
{ "run_id": "g_1", "eval": "task_success", "agreed": 18, "examples": 20, "false_passes": 1, "false_fails": 1, "complete": true, "unreliable": false, "model": "…" }
```

With fewer than 10 `examples` the result says nothing. `unreliable: true` means the Judge disagrees with the golden answers too often.

## Errors

| Status | Code | Meaning |
| - | - | - |
| 402 | `INSUFFICIENT_CREDITS` | The balance is too low to start |
| 403 | `POLICY_DENY` | Your role cannot run simulations, the workspace is not on an active Pro or Business plan, or the API key lacks the `agents` scope |
| 404 | `AGENT_NOT_FOUND` | No agent with this ID in your workspace |
| 429 | `RATE_LIMITED` | More than 3 starts a minute |

## Example

```bash cURL theme={null}
curl -X POST https://api.60db.ai/agents/AGENT_ID/evals/task_success/golden \
  -H "Authorization: Bearer your-api-key"
```


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