# Edit a suggested fix

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Evaluation & reporting](https://everruns.com/docs/api/groups/evaluation-reporting/)/Edit a suggested fix

# Edit a suggested fix

Preview

Change the text a suggested fix adds to the agent’s instructions. An edited fix must be checked again before it can be applied.

Public APIRequires the evals feature flag

PATCH`/v1/evals/fixes/{fix_id}`

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

## Parameters

### Path Parameters

**fix_id**

required

string

Prefixed public identifier

## Request Bodyrequired

Media typeapplication/json

New text for a fix. It must be checked again.

object

**addition**

required

The text to add to the agent’s instructions.

string

**summary**

One line on what the change does. Unchanged when omitted.

string | null

### Example generated

```json
{
  "addition": "example",
  "summary": "example"
}
```

## Responses

200Success

### 200

Success

Media typeapplication/json

A suggested change to an agent’s instructions, written by the Inspector for a finding, and where checking and approving it stand.

object

**addition**

required

The text added to the end of the agent’s instructions.

string

**agent_id**

required

The agent whose instructions the fix changes.

string

**check**

One of:

* object

  The last check’s result.

  object

  **broke**

  required

  Cases the fix made fail.

  integer format: int32

  **cases**

  required

  Cases that ran on both sides.

  integer format: int32

  **current**

  required

  The agent as it is.

  object

  **cost_usd**

  required

  What the side’s trials cost in USD.

  number format: double

  **pass_rate**

  required

  Share of all trials that passed, 0 to 1.

  number format: double

  **passed**

  required

  Cases that passed every trial.

  integer format: int32

  **dataset_version**

  required

  The eval’s dataset version at the check.

  integer format: int32

  **eval_name**

  required

  Name of the eval the check ran.

  string

  **fixed**

  required

  Cases the fix made pass.

  integer format: int32

  **trials**

  required

  Trials per case and side.

  integer format: int32

  **verdict**

  required

  How the variant with the fix compares, noise taken into account.

  string

  Allowed values: improvement regression within_noise not_enough_data

  **with_fix**

  required

  The agent with the addition.

  object

  **cost_usd**

  required

  What the side’s trials cost in USD.

  number format: double

  **pass_rate**

  required

  Share of all trials that passed, 0 to 1.

  number format: double

  **passed**

  required

  Cases that passed every trial.

  integer format: int32

* null

  null

**created_at**

required

When the Inspector wrote the fix.

string format: date-time

**current**

required

False when the agent’s instructions changed after the last check, so the fix needs checking again before it can be applied.

boolean

**decided_at**

When a person applied or rejected the fix.

string | null format: date-time

**decision_note**

Why it was rejected.

string | null

**eval_id**

The eval the last check ran, while or after it runs.

string | null

**experiment_id**

The last check’s experiment, while or after it runs.

string | null

**id**

required

Prefixed public identifier of the fix.

string

**issue_id**

required

The finding the fix is for.

string format: uuid

**status**

required

`proposed` (not checked), `checking`, `verified` (checked, no regressions), `regressed`, `check_failed`, `applied` or `rejected`.

string

**summary**

required

One line on what the change does.

string

### Example

```json
{
  "agent_id": "agent_550e8400e29b41d4a716446655440000",
  "check": {
    "verdict": "improvement"
  },
  "id": "fix_0190f3a1b2c37d8e9f00112233445566"
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/evals/fixes/example';
const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: '{"addition":"example","summary":"example"}'
};


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

Request

```sh
curl --request PATCH \
  --url https://app.everruns.com/api/v1/evals/fixes/example \
  --header 'Content-Type: application/json' \
  --data '{ "addition": "example", "summary": "example" }'
```

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

200

200 · Success

```json
{
  "addition": "string",
  "agent_id": "agent_550e8400e29b41d4a716446655440000",
  "created_at": "2026-10-12T09:00:00Z",
  "current": true,
  "id": "fix_0190f3a1b2c37d8e9f00112233445566",
  "issue_id": "string",
  "status": "string",
  "summary": "string"
}
```

## Matching endpoints