---
title: "Update an eval suite's settings"
method: PATCH
path: "/projects/{projectId}/eval-suites/{suiteId}"
tags: ["Eval runs"]
---

# Update an eval suite's settings

`PATCH /projects/{projectId}/eval-suites/{suiteId}`

Partial update — omitted fields are left as they are. `environmentIds` is tri-state: a non-empty array sets/replaces, `null` clears (reverting the suite to legacy config), and `[]` is rejected rather than silently treated as a clear. Responds with the full updated suite.

## Path parameters

- `projectId` string, required
- `suiteId` string, required

## Request body

- EvalSuiteUpdateRequest — Partial update of a suite's settings. Omitted fields are left as they are.
  - `name` string
  - `description` string
  - `environment` object — LEGACY server bag. Unrelated to `environmentIds`.
    - `servers` string[]
  - `environmentIds` string[], nullable — Tri-state: a non-empty array sets/replaces the attachments, `null` CLEARS them (reverting the suite to legacy config), and `[]` is REJECTED rather than silently read as a clear.
  - `executionConfig` object
    - `model` string
    - `systemPrompt` string
    - `temperature` number
  - `hosts` object[]

## Response `200`

The updated suite.

- EvalSuiteDetail — One eval suite's full configuration. Distinct from the `EvalSuite` summary returned by the list route, which carries run rollups instead of settings.
  - `id` string, required
  - `name` string, nullable
  - `description` string, nullable
  - `projectId` string, nullable
  - `environment` object, required — LEGACY server bag, kept as rollback data. Unrelated to `environmentIds`.
    - `servers` string[]
  - `executionConfig` object, nullable
    - `model` string
    - `systemPrompt` string
    - `temperature` number
  - `hosts` object[], required
    - `id` string, required
    - `name` string, required
    - `servers` string[]
  - `environmentIds` string[], required — Attached project environments, in attach order.
  - `settings` object, required
    - `minimumAccuracy` number, nullable — Minimum pass rate for the suite to count as passing.
    - `matchOptions` object, nullable
    - `checks` object[]
    - `judge` object — Goal-completion judge. Absent config reads as enabled.
      - `enabled` boolean
      - `model` string, nullable
  - `schedule` EvalSuiteSchedule, required — Recurring-run schedule. A schedule fires exactly ONE run, so an environment-based suite pins the environment it runs against.
    - `enabled` boolean, required
    - `intervalMinutes` integer, nullable — Minutes between runs. 5 minutes to 7 days.
    - `environmentId` string, nullable — The single attached environment scheduled runs use. Null on a legacy (non-environment) suite.
  - `createdAt` number, nullable — Epoch milliseconds.
  - `updatedAt` number, nullable

## Other responses

- `400` — Malformed body or parameters.
- `401` — Missing, invalid, revoked, or orphaned key (`UNAUTHORIZED`) — or the **target MCP server** needs an OAuth grant (`OAUTH_REQUIRED`), which is a property of the server, not your key.
- `403` — Key is valid but not allowed to do this.
- `404` — Unknown project, server, or resource.
- `409` — The resource is not in a state that accepts this write — a stale `expectedRevision`, a duplicate name, or an environment that cannot currently be launched. The request was well-formed; re-read the resource and retry.
- `429` — Per-key rate limit exceeded (60 requests/minute sustained, bursts up to 10). Honor `Retry-After` and back off with jitter.
- `500` — Something failed on MCPJam's side.
- `502` — Could not connect to the target MCP server.

---

[API](https://skmtc.net/mcpjam/apis/mcpjam-api.md) · [All operations](https://skmtc.net/mcpjam/apis/mcpjam-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mcpjam/mcpjam-api/revisions/b8c36aef7731/schema)