---
title: "Replace evaluators"
method: PUT
path: "/api/v1/automations/{id}/evaluators"
tags: ["Evaluation"]
---

# Replace evaluators

`PUT /api/v1/automations/{id}/evaluators`

Replace the evaluator YAML for an automation. The submitted YAML is validated before it becomes the source for future experiment scores.

## Path parameters

- `id` string, required — Automation id or typed alias.

## Request body

- EvaluatorConfigUpdate — Replacement evaluator configuration.
  - `yaml` string, required — Complete evaluator YAML to validate and store.

## Response `200`

Updated evaluator YAML and parsed configuration.

- EvaluatorConfigResponse — Evaluator YAML and parsed evaluator configuration for an automation.
  - `automationId` string, required — Automation that owns this evaluator config.
  - `automationType` 'workflow' | 'agent', required
  - `yaml` string, required — Evaluator configuration YAML.
  - `config` object, required
    - `evaluators` unknown[], required — Parsed evaluator definitions from the YAML.
      - unknown
    - `passThreshold` number, required — Overall score threshold required for the experiment to pass.

## Other responses

- `400` — Validation error. Request shape did not match the spec.
- `401` — Missing or invalid API key
- `403` — API key lacks required scope
- `404` — Resource not found
- `413` — Payload too large. Upload exceeded the per-request size cap.
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/eigenpal/apis/eigenpal-api.md) · [All operations](https://skmtc.dev/eigenpal/apis/eigenpal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eigenpal/eigenpal-api/revisions/dddcddf1975c/schema)