Skip to main content
PATCH
Update an eval suite's settings

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId
string
required

ID of the hosted project that contains the server.

suiteId
string
required

Eval suite ID, as returned by POST /eval-runs.

Body

application/json

Partial update of a suite's settings. Omitted fields are left as they are.

name
string
Minimum string length: 1
description
string
environment
object

LEGACY server bag. Unrelated to environmentIds.

environmentIds
string[] | null

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.

Minimum array length: 1
Minimum string length: 1
executionConfig
object
hosts
object[]

Response

The updated suite.

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
environment
object
required

LEGACY server bag, kept as rollback data. Unrelated to environmentIds.

hosts
object[]
required
environmentIds
string[]
required

Attached project environments, in attach order.

settings
object
required
schedule
object
required

Recurring-run schedule. A schedule fires exactly ONE run, so an environment-based suite pins the environment it runs against.

name
string | null
description
string | null
projectId
string | null
executionConfig
object | null
createdAt
number | null

Epoch milliseconds.

updatedAt
number | null