latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-23174237683.4 KB

9a3b3893f016

Eval runs

Update an eval suite's settings

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.

patch/projects/{projectId}/eval-suites/{suiteId}

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

suiteIdstring required

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

Request body

namestring
descriptionstring
environmentIdsstring[] 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.

Response

The updated suite.

idstring required
declaredIdstring

The suite's declared file identity (suite.id in a suite file). Present on file-owned suites; absent on UI-authored suites, which have no declared id and cannot be claimed by eval run --file.

namestring nullable
descriptionstring nullable
projectIdstring nullable
environmentIdsstring[]

Attached project environments, in attach order.

createdAtnumber nullable

Epoch milliseconds.

updatedAtnumber nullable