Skip to main content
POST
Resolve or create a file-owned eval suite

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.

Body

application/json

Declared identity and hosted settings for a file-owned suite. The inspector parses the suite file; this is not the raw file.

declaredSuiteId
string
required

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

name
string
required
sourceHash
string
required

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

Pattern: ^[a-f0-9]{64}$
description
string
provenance
object
environment
object
defaultConfig
object
minIterations
integer
Required range: 1 <= x <= 10
defaultPassCriteria
object

Response

The existing file-owned suite was updated.

created
boolean
required

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

suite
object
required

One eval suite's full configuration. Distinct from the EvalSuite summary returned by the list route, which carries run rollups instead of settings.