---
title: "Update evaluation config"
method: PATCH
path: "/agents/{agent_id}/evaluation-config"
tags: ["Evaluations"]
---

# Update evaluation config

`PATCH /agents/{agent_id}/evaluation-config`

Partially update the evaluation configuration for an agent.
Omitted fields keep their current value. Provided list fields (criteria, tags, data_points) replace that list entirely.

Requires Pro tier or above.

## Path parameters

- `agent_id` string, required

## Request body

- object
  - `enabled` boolean — Whether evaluations are enabled for this agent.
  - `model_name` string — LLM model to use for evaluation.
  - `include_auto_tags` boolean — Allow the evaluator to suggest tags beyond your predefined vocabulary.
  - `criteria` object[] — Quality criteria to check (replaces existing list). Max 30.
    - `name` string
    - `prompt` string — True/false statement to evaluate.
    - `type` 'prohibited_action' | 'prohibited_words' | 'voice_tone' | 'other'
    - `priority` 'needs_review' | 'needs_attention'
  - `tags` object[] — Tag vocabulary (replaces existing list). Max 50.
    - `name` string
    - `description` string
  - `data_points` object[] — Data points to extract (replaces existing list). Max 40.
    - `name` string
    - `data_type` 'string' | 'boolean' | 'integer' | 'number'
    - `description` string
  - `sentiment` object
    - `enabled` boolean
    - `affects_grade` boolean
    - `description` string

## Response `200`

Updated evaluation configuration.

- object
  - `config` EvaluationConfig
    - `agent_id` string
    - `enabled` boolean
    - `is_active` boolean
    - `model_name` string, nullable
    - `frequency` string, nullable
    - `language` string, nullable
    - `include_auto_tags` boolean
    - `interaction_types` string[]
    - `criteria` object[]
      - `id` string
      - `name` string
      - `prompt` string
      - `type` string
      - `priority` string
    - `tags` object[]
      - `name` string
      - `description` string
    - `data_points` object[]
      - `id` string
      - `name` string
      - `data_type` string
      - `description` string
    - `sentiment` object, nullable
      - `enabled` boolean
      - `affects_grade` boolean
      - `description` string
    - `updated_ts` string, nullable

## Other responses

- `400` — Invalid request (e.g. exceeds limits).
- `401` — Unauthorized — missing or invalid credentials.
- `403` — Forbidden — requires Pro tier or insufficient permissions.

---

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