# Ask the Eval Builder for cases

Source: <https://everruns.com/docs/api/operations/propose_eval_cases/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Evaluation & reporting](https://everruns.com/docs/api/groups/evaluation-reporting/)/Ask the Eval Builder for cases

# Ask the Eval Builder for cases

Preview

Ask the Eval Builder to propose eval cases for an agent from its instructions, its recent sessions and the gaps in its datasets. Runs in the background on the organization’s default model; nothing is added until a person accepts a proposal.

Public APIRequires the evals feature flag

POST`/v1/agents/{agent_id}/eval-proposals`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**agent_id**

required

string

Prefixed public identifier

## Responses

201Created

### 201

Created

Media typeapplication/json

One request to the Eval Builder for an agent.

object

**completed_at**

When it finished.

string | null format: date-time

**cost_usd**

What the model call cost, when the provider reported it.

number | null format: double

**error**

Why it failed, in words for a person.

string | null

**id**

required

Run identifier.

string

**model**

Model that wrote the proposals.

string | null

**proposals**

required

Proposals it made.

integer format: int32

**sessions_read**

required

Production sessions it read.

integer format: int32

**started_at**

required

When it started.

string format: date-time

**status**

required

Where the run is.

string

Allowed values: running done failed unavailable

### Example

```json
{
  "cost_usd": 0.012,
  "id": "evalbuild_01933b5a000070008000000000000001",
  "model": "gpt-6.2-sol",
  "proposals": 5,
  "sessions_read": 6,
  "status": "running"
}
```

409A run for this agent is still going

### 409

A run for this agent is still going

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/agents/example/eval-proposals';
const options = {method: 'POST'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/agents/example/eval-proposals
```

Additional language examples require JavaScript. The default request example is available above.

201409

201 · Created

```json
{
  "cost_usd": 0.012,
  "id": "evalbuild_01933b5a000070008000000000000001",
  "model": "gpt-6.2-sol",
  "proposals": 5,
  "sessions_read": 6,
  "started_at": "2026-10-12T09:00:00Z",
  "status": "running"
}
```

409 · A run for this agent is still going

No response body example is declared for this status.

## Matching endpoints