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

9a3b3893f016

Eval runs

Resolve or create a file-owned eval suite

Resolve a file-owned suite by declared id within the project, or create one. Lookup is by (projectId, declaredSuiteId) and never by name. A UI-authored suite has no declared id and cannot be claimed. The inspector parses the suite file; this body is the declared identity, source hash, optional provenance, and hosted settings — not the raw file.

201 on first create; 200 on a later update of the same declared id.

post/projects/{projectId}/eval-suites/from-file

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

Request body

declaredSuiteIdstring required

The file's suite.id. Lookup is by this id within the project, never by name.

namestring required

descriptionstring

sourceHashstring required

SHA-256 hex of the suite-file bytes. Lowercase, 64 characters.

minIterationsinteger

Response

The existing file-owned suite was updated.

createdboolean required

True on the first upload of this declared id in the project; false on a later update of the same suite.