--- title: "List a suite's runs" method: GET path: "/projects/{projectId}/eval-suites/{suiteId}/runs" tags: ["Eval runs"] --- # List a suite's runs `GET /projects/{projectId}/eval-suites/{suiteId}/runs` Recent runs for a suite, newest first. ## Path parameters - `projectId` string, required - `suiteId` string, required ## Query parameters - `limit` integer ## Headers - `x-mcpjam-eval-vocabulary` '1' | '2' ## Response `200` Recent runs, newest first. - EvalRunPage - `items` EvalRun[], required - `client` object — Durable execution client, omitted on older runs without a descriptor. Separate from launcher identity. - `id` string, nullable, required - `name` string, required - `source` 'environment' | 'attached_host' | 'suite_default' | 'sdk', required - `hostStyle` string - `modelId` string - `id` string, required - `suiteId` string, required - `runNumber` integer, nullable - `status` 'pending' | 'running' | 'grading' | 'completed' | 'failed' | 'cancelled' | 'timed_out', required — Poll until TERMINAL. The four terminal statuses are `completed`, `failed`, `cancelled` and `timed_out`. `grading` is NOT terminal: every trial has finished and the run is being held for its gating judge — up to 30 minutes — with `result` still `pending`. A poller that stops at `grading` reports a run with no verdict as though it had one. - `result` 'passed' | 'failed' | 'inconclusive' | 'null', nullable — Verdict once terminal. `inconclusive` exists only under `verdictPolicyVersion: 2` and is NOT a failure: the run did not measure the server well enough to say (too few gradeable trials, too many evaluator errors), so a gate that folds it into `failed` reports a defect the run never observed. Read `verdictSummary.reasons` for the check that withheld the verdict. - `summary` object, nullable - `total` integer - `passed` integer - `failed` integer - `passRate` number - `source` 'ui' | 'api' | 'sdk' | 'schedule' | 'github_check' | 'benchmark', required — Run origin, STAMPED BY THE SERVER and not settable by a caller. Every run created through this API is `api` — including one launched by the CLI, by a GitHub Actions job, or by an MCP agent, because from the server's side all three are API calls. The caller's own claim about which of those it is rides on `launcher`. `schedule` and `github_check` are written by the platform's scheduled-eval and PR-check workers; `benchmark` marks a Connector Bench matrix cell and is hidden from project run lists. - `launcher` object — The run's DECLARED launcher — what the launching process says it is, sent as the `x-mcpjam-launcher` request header at launch. A LABEL, never an authorization input: `source` above is the stamped, unforgeable answer and `attribution` below is the verified one. Allowlisted to the three origins the server cannot observe for itself. ABSENT when the launcher declared nothing, which is not the same as `ui`. - `kind` 'cli' | 'mcp' | 'github_action', required - `client` string — Name of the launching program, e.g. `mcpjam-cli`, or an MCP client's user-agent. - `version` string - `attribution` object — VERIFIED agent attribution, minted by the platform from the credential this run authenticated with — never from anything the caller sent. The audit-grade half of the pair: `launcher` says what the client called itself, `surface` says what the credential proved. Descriptive only; nothing reads it to decide access. ABSENT when the credential carried no attribution claims. - `surface` 'rest' | 'cli' | 'mcp' | 'slack' | 'discord' | 'workspace', required - `apiKeyId` string — The API key id the request authenticated with. The KEY, never the secret. - `notes` string, nullable - `createdAt` number, required — Epoch milliseconds. - `completedAt` number, nullable — Epoch milliseconds, `null` until terminal. - `scoreIntegrity` 'valid' | 'invalid' | 'null', nullable — Whether the run's score evidence verified at ingest. TRI-STATE, and the third state matters: `valid` means the backend checked and definitions and results agree; `invalid` means they do not; `null` (or absent) means NO VERDICT was produced, on a deployment that predates integrity checking. A score gate must treat `null` exactly like `invalid` — absent evidence is not valid evidence. - `verdictPolicyVersion` 2 — Which criterion decided this run, frozen at run start. `2` is PER-CASE GRADING; ABSENT means the SUITE-WIDE ACCURACY THRESHOLD — `result` cannot then be `inconclusive`, because that criterion has no validity phase, and there is no `verdictSummary`. The `2` is a wire spelling, not a version a caller upgrades to. A caller gating on fractions or on validity must read this FIRST rather than assume a missing summary means a clean run. - `verdictSummary` object — How a policy-2 verdict was reached: the resolved validity policy, the measured completion and evaluator-error rates with their denominators and exclusions, the per-case and per-execution-variant aggregates, and the exact reasons. Absent when the run is legacy, or when the stored summary failed contract validation at the boundary — a partially-valid decision is never published, because a gate cannot tell a missing field from a satisfied check. - `verdictPolicyIntegrityError` string — Why a policy-2 run could not be decided from its own evidence (a missing or malformed policy snapshot, mixed evaluator configs). Accompanies an `inconclusive` result; it is never a task failure. - `environment` EvalRunEnvironment, nullable — The project environment a run is pinned to, at the revision resolved when it launched. `null` for a legacy run that used the suite's saved server selection. - `id` string, required - `name` string, nullable - `revision` integer, nullable — The environment revision the run executed against. - `runGroupId` string — Shared by every per-target run from the same fan-out launch. Absent on a single-target launch and on rows created before run groups. - `effectiveModelId` string — Model the run actually executed with. Absent on pre-attribution rows. - `modelSource` 'client_default' | 'override' | 'case' — `client_default` inherited the host model; `override` used the environment's `modelId`; `case` used the sole model in the case snapshot. - `executionEngine` string — Which engine executed the run: `emulated` (the platform's own turn loop) or `harness:` (a real agent runtime such as Claude Code). ABSENT means the run recorded no engine — a run created before the platform attributed one. Treat that as UNKNOWN, never as `emulated`: those are different claims, and the runs whose engine was never recorded are exactly the ones a reader must not vouch for. - `insights` InsightsEnvelope — The common insights envelope, shared by eval runs, swarm waves and user-testing windows. One shape for three producers, so a caller writes the reading code once. An ABSENT envelope and `status: "not_available"` mean the same thing and both are normal: the field is an enrichment, and a caller who may not have it gets the resource without it rather than an error. - `schemaVersion` 1, required - `scope` InsightScope, required — What this envelope is about. The extra fields depend on `kind`. - `kind` 'eval_run' | 'swarm_wave' | 'user_testing_window', required - `id` string, required - `runId` string — `swarm_wave` only. - `scenarioId` string — `user_testing_window` only. - `windowStartAt` integer — `user_testing_window` only. - `windowEndAt` integer — `user_testing_window` only. - `status` 'not_available' | 'not_requested' | 'pending' | 'completed' | 'failed', required — `not_available` means this deployment cannot produce insights at all — treat an ABSENT envelope the same way. `not_requested` means nobody has asked. `pending` means one is running: poll, do not re-request. - `reasonCode` string, nullable, required - `retryable` boolean, required — Whether asking again could produce a different answer. False on a `failed` envelope means the input, not the attempt, was the problem. - `error` object, nullable, required - `code` string, required - `message` string, required - `generatedAt` integer, nullable, required - `updatedAt` integer, nullable, required - `summary` string, nullable, required - `coverage` object, required — READ THIS BEFORE QUOTING ANY FINDING. `truncated` and `lowConfidence` are the difference between "this happens" and "this happened in the part we looked at". - `unit` 'iterations' | 'sessions', required - `analyzed` integer, required - `total` integer, required - `gradedCount` integer - `feedbackCount` integer - `truncated` boolean, required — The analysis saw `analyzed` of `total`, not all of it. - `lowConfidence` boolean, required — Too little was analyzed to generalize. Findings still stand as observations of what WAS seen. - `findings` ActionableFinding[], required - `id` string, required — Stable remediation id (`rf_<16 hex>`). Survives dynamic error values, so the same problem keeps the same id across runs — dismiss it once and it stays dismissed. - `signalFingerprint` string, required — The registry signal this derives from. Several findings can share one. - `title` string, required - `category` 'unknown' | 'tool_contract' | 'tool_runtime' | 'capability_gap' | 'workflow' | 'agent_behavior' | 'test_design' | 'environment', required - `attribution` 'unknown' | 'server_contract' | 'server_runtime' | 'server_capability' | 'agent_or_prompt' | 'test_design' | 'environment', required — WHOSE problem this is. `server_*` points at the MCP server; `agent_or_prompt` and `test_design` point back at the caller. - `actionTarget` 'investigate' | 'mcp_server' | 'agent_configuration' | 'eval_case' | 'environment', required — What you would change to fix it. - `actionability` 'informational' | 'investigate' | 'ready', required — `ready` means the finding names a specific target and change. `investigate` means it does not yet. `informational` means there is nothing to do. - `severity` 'info' | 'low' | 'medium' | 'high', required - `confidence` 'low' | 'medium' | 'high', required - `observed` string, required — DETERMINISTIC observation — counts and identities, never model prose. This is the part you can verify yourself. - `rootCause` string - `recommendation` string, required - `acceptanceCriteria` string[], required — How you would know the fix worked. - `affected` object, required — How much of the analyzed population hit this. Read it as a ratio — `1/40` and `38/40` are different problems. - `count` integer, required - `total` integer, required - `unit` 'iterations' | 'sessions', required - `patternSlug` string - `target` object — Present only when a server (and, for tool surfaces, a tool) resolved against the pinned snapshot. Required for `mcp_server` / `ready`. - `serverId` string, required - `toolName` string - `surface` 'description' | 'input_schema' | 'output_schema' | 'handler' | 'server_instructions' | 'capability', required - `fieldPath` string - `snapshotHash` string, required — The pinned snapshot the target resolved against, so a finding cannot silently re-point at a definition that changed after it was written. - `currentDefinition` object - `description` string - `inputSchemaJson` string - `outputSchemaJson` string - `truncated` boolean, required - `evidence` ActionableFindingEvidence[], required - `sessionId` string - `iterationId` string - `kind` 'tool_error' | 'transcript' | 'feedback' | 'judge' | 'contrast', required - `excerpt` string, required — Scrubbed and clipped at the producer. Never a full transcript. - `toolName` string - `errorCode` string - `currentFindings` ActionableFinding[] — Absent on a deployment that predates findings. The always-available observation view: findings assembled from deterministic evidence plus any identity-matching model enrichment, populated INDEPENDENTLY of `status`. Read `currentFindings ?? findings` — and treat an explicit `[]` as a real "nothing here needs a change" rather than falling back to the generated array. - `id` string, required — Stable remediation id (`rf_<16 hex>`). Survives dynamic error values, so the same problem keeps the same id across runs — dismiss it once and it stays dismissed. - `signalFingerprint` string, required — The registry signal this derives from. Several findings can share one. - `title` string, required - `category` 'unknown' | 'tool_contract' | 'tool_runtime' | 'capability_gap' | 'workflow' | 'agent_behavior' | 'test_design' | 'environment', required - `attribution` 'unknown' | 'server_contract' | 'server_runtime' | 'server_capability' | 'agent_or_prompt' | 'test_design' | 'environment', required — WHOSE problem this is. `server_*` points at the MCP server; `agent_or_prompt` and `test_design` point back at the caller. - `actionTarget` 'investigate' | 'mcp_server' | 'agent_configuration' | 'eval_case' | 'environment', required — What you would change to fix it. - `actionability` 'informational' | 'investigate' | 'ready', required — `ready` means the finding names a specific target and change. `investigate` means it does not yet. `informational` means there is nothing to do. - `severity` 'info' | 'low' | 'medium' | 'high', required - `confidence` 'low' | 'medium' | 'high', required - `observed` string, required — DETERMINISTIC observation — counts and identities, never model prose. This is the part you can verify yourself. - `rootCause` string - `recommendation` string, required - `acceptanceCriteria` string[], required — How you would know the fix worked. - `affected` object, required — How much of the analyzed population hit this. Read it as a ratio — `1/40` and `38/40` are different problems. - `count` integer, required - `total` integer, required - `unit` 'iterations' | 'sessions', required - `patternSlug` string - `target` object — Present only when a server (and, for tool surfaces, a tool) resolved against the pinned snapshot. Required for `mcp_server` / `ready`. - `serverId` string, required - `toolName` string - `surface` 'description' | 'input_schema' | 'output_schema' | 'handler' | 'server_instructions' | 'capability', required - `fieldPath` string - `snapshotHash` string, required — The pinned snapshot the target resolved against, so a finding cannot silently re-point at a definition that changed after it was written. - `currentDefinition` object - `description` string - `inputSchemaJson` string - `outputSchemaJson` string - `truncated` boolean, required - `evidence` ActionableFindingEvidence[], required - `sessionId` string - `iterationId` string - `kind` 'tool_error' | 'transcript' | 'feedback' | 'judge' | 'contrast', required - `excerpt` string, required — Scrubbed and clipped at the producer. Never a full transcript. - `toolName` string - `errorCode` string - `observationState` 'ready' | 'partial' | 'unavailable' — How much of the population `currentFindings` describes — distinct from `status`, which describes a model GENERATION. `unavailable` means nothing could be measured, which is NOT the same as an empty `currentFindings`. - `observationCoverage` object — Coverage for `currentFindings`, describing ITS population. Deliberately separate from `coverage`, whose counters describe the generation's population. - `unit` 'iterations', required - `analyzed` integer, required - `total` integer, required - `gradedCount` integer, required - `exclusions` object, required — Counted reasons an iteration was left out, keyed by reason. An OPEN map: a new exclusion class must not require a consumer change to keep validating. - `unifiedFindings` object — Absent on a deployment that predates findings. Its PRESENCE says the deployment serves findings; `snapshot: null` says this run has none built yet — two different answers a caller must not conflate. - `capability` 'unified_findings_v1', required - `analysis` object — The trace analysis pipeline's progress while one exists for the run. Absent when none has been requested. - `phase` 'reading' | 'grouping' | 'checking' | 'done' | 'failed', required - `progress` object, required - `done` integer, required - `total` integer, required - `unit` 'iterations', required - `models` string[], required - `completeness` object, required - `iterationReports` integer, required - `total` integer, required - `missingTraces` integer, required - `snapshot` object, nullable, required — The built findings snapshot: its deterministic findings, per-finding provenance, and any pipeline-verified mechanisms. `null` means none has been built for this run. - `job` object, nullable, required — The in-flight or last-failed operation, so a refusal never renders as a completed analysis. - `canBuild` boolean, required - `canEnrich` boolean, required - `runHealth` object — Swarm only. Launch outcomes never appear as findings — a run that could not start is an operational fact, not something the server under test did. - `targets` object[], required - `subjectKind` 'environment' | 'host', required - `subjectId` string, required - `subjectLabel` string, required - `attempted` integer, required - `succeeded` integer, required - `failed` integer, required - `rateLimited` integer, required - `truncation` object, required — What this RESPONSE dropped to stay a sane size, as distinct from what the ANALYSIS did not look at (`coverage`). - `truncated` boolean, required - `omittedFindings` integer, required - `omittedEvidence` integer, required - `contractTruncated` boolean, required - `journeyFindings` SwarmJourneyFindings - `contractVersion` 1, required - `generatedAt` integer, required - `sourceRevision` string, required - `pipelineVersion` integer, required - `extractionVersion` integer, required - `extractionModel` string, required - `reasoningModel` string, required - `summaryKind` 'notLaunched' | 'broken' | 'friction' | 'landed' | 'ungraded' | 'unread', required — `notLaunched`, `broken`, `friction`, `landed`, `ungraded`, `unread` - `population` object, required - `configured` integer, required - `started` integer, required - `read` integer, required - `unread` integer, required - `withdrawn` integer, required - `limited` integer, required - `graded` integer, required - `coverageNotes` string[], required - `disclosure` object, required - `rail` 'gateway' | 'openrouter', required - `evidenceSent` string[], required - `personas` object[], required - `persona` object, required - `personaRefId` string, nullable, required - `name` string, required - `disposition` 'notRun' | 'blockedConnecting' | 'lostFindingTool' | 'blockedCallingTool' | 'blockedByResponse' | 'goalMissed' | 'goalMetWithFriction' | 'goalMet' | 'notMeasured', required — `notRun`, `blockedConnecting`, `lostFindingTool`, `blockedCallingTool`, `blockedByResponse`, `goalMissed`, `goalMetWithFriction`, `goalMet`, `notMeasured` - `tone` 'fail' | 'warn' | 'ok' | 'muted', required - `goalRunIds` string[], required - `findings` SwarmJourneyFinding[], required - `id` string, required - `basis` 'verifiedMechanism' | 'sessionReport' | 'populationFact', required — `verifiedMechanism`, `sessionReport`, `populationFact` - `scopeLevel` 'session' | 'goal' | 'persona' | 'target' | 'wave', required — `session`, `goal`, `persona`, `target`, `wave` - `persona` object, required - `personaRefId` string, nullable, required - `name` string, required - `goal` object, required - `runId` string, required - `journeyRefId` string, required - `title` string, required - `target` object, required - `kind` 'environment' | 'host', required - `id` string, required - `label` string, required - `modelId` string, nullable, required - `population` object, required - `count` integer, required - `total` integer, required - `unit` 'sessions', required - `sessionIds` string[], required - `citations` string[], required - `verdictSeen` 'passed' | 'failed' | 'inconclusive' | 'notEstablished', required - `chainStage` 'connection' | 'discovery' | 'selection' | 'call' | 'response' | 'userValue', nullable, required — `connection`, `discovery`, `selection`, `call`, `response`, `userValue` - `chainStageState` 'passed' | 'failed' | 'notReached' | 'notMeasured' | 'notApplicable', nullable, required — `passed`: passed; `failed`: failed; `notReached`: never ran (an earlier stage failed); `notMeasured`: not measured; `notApplicable`: not applicable to this case - `chainStageBasis` 'derived' | 'reported' | 'unmeasured', required - `disposition` 'notRun' | 'blockedConnecting' | 'lostFindingTool' | 'blockedCallingTool' | 'blockedByResponse' | 'goalMissed' | 'goalMetWithFriction' | 'goalMet' | 'notMeasured', required — `notRun`, `blockedConnecting`, `lostFindingTool`, `blockedCallingTool`, `blockedByResponse`, `goalMissed`, `goalMetWithFriction`, `goalMet`, `notMeasured` - `tone` 'fail' | 'warn' | 'ok' | 'muted', required - `coverageNotes` string[], required - `outcomePhrase` string, nullable, required - `mechanismPhrase` string, nullable, required - `fixPhrase` string, nullable, required - `reportExcerpt` object, nullable, required - `actual` string, required - `account` string, nullable - `citations` string[], required - `mechanismId` string, nullable, required - `signal` 'outputTruncated' | 'hallucinatedTool' | 'toolErrored' | 'noToolCalled' | 'turnCapReached', nullable — `outputTruncated`, `hallucinatedTool`, `toolErrored`, `noToolCalled`, `turnCapReached` - `verification` object - `proposed` integer, required - `confirmed` integer, required - `rejected` integer, required - `unverified` integer, required - `omitted` integer, required - `journeyFindingsJob` SwarmJourneyFindingsJob - `status` 'pending' | 'completed' | 'failed' | 'skipped', required - `errorCode` string - `updatedAt` integer, required - `judges` EvalRunJudges — Advisory graders on a run, keyed by judge. An envelope rather than a bare `judge` field because goal completion is one of several; a future judge is a new key here, not a reshaped response. - `goalCompletion` EvalRunGoalCompletionJudge — Goal completion: grades each case's final answer against its expected output. - `progress` object - `total` number, required - `completed` number, required - `errors` number, required - `skipped` number, required - `judgeTemplateVersion` number - `judgeTemplateHash` string - `status` 'pending' | 'completed' | 'failed' | 'null', nullable, required — `null` means this judge was NEVER requested for the run — a different answer from "requested and graded nothing". Poll rather than re-requesting while `pending`. - `errorCode` string, nullable, required — Machine-readable failure reason, set alongside `status: "failed"`. - `summary` string, nullable, required - `generatedAt` number, nullable, required — Epoch milliseconds. - `modelUsed` string, nullable, required - `threshold` number, nullable, required — The threshold these results were scored against (`passed = score >= threshold`). - `cases` EvalRunGoalCompletionCase[], required — Per-iteration measurements and unscored error or skipped rows on terminal jobs. Failed jobs retain completed measurements. Pending jobs expose progress and an empty cases array. - `status` 'scored' | 'error' | 'skipped' — Measurement state. Interpret score and passed only for scored rows. Legacy scored rows are projected as scored. - `gradingKey` string - `errorCode` string - `judgeTemplateVersion` number - `judgeTemplateHash` string - `evidenceHash` string - `evidenceManifest` object - `version` 1, required - `traceComplete` true, required - `traceFields` string[], required - `messageCount` number, required - `spanCount` number, required - `artifactSources` object[], required - … - `uncaptured` string[], required - `inputBytes` number, required - `caseKey` string, required — The stable AUTHORED-case identity, as persisted. NOT a case row id — do not join it against the ids the per-case routes take. - `iterationId` string — The iteration this case graded. The join key between a judge case and the iterations the run returns; `caseKey` is a storage key and joins to nothing. Absent on judge results written before it was persisted. - `score` number, nullable, required - `passed` boolean, required - `reason` string, nullable, required - `rubricHits` string[], required — Rubric criteria the answer satisfied. - `groundedness` EvalRunGroundednessJudge — Groundedness: grades whether each answer is SUPPORTED by its tool trajectory. - `status` 'pending' | 'completed' | 'failed' | 'null', nullable, required — `null` means this judge was NEVER requested for the run — a different answer from "requested and graded nothing". Poll rather than re-requesting while `pending`. - `errorCode` string, nullable, required — Machine-readable failure reason, set alongside `status: "failed"`. - `summary` string, nullable, required - `generatedAt` number, nullable, required — Epoch milliseconds. - `modelUsed` string, nullable, required - `threshold` number, nullable, required — The threshold these results were scored against (`passed = score >= threshold`). - `cases` EvalRunGroundednessCase[], required — Per-case grades. EMPTY unless `status` is `completed`. - `caseKey` string, required — The stable AUTHORED-case identity, as persisted. NOT a case row id — do not join it against the ids the per-case routes take. - `iterationId` string — The iteration this case graded. The join key between a judge case and the iterations the run returns; `caseKey` is a storage key and joins to nothing. Absent on judge results written before it was persisted. - `score` number, nullable, required - `passed` boolean, required - `reason` string, nullable, required - `unsupportedClaims` string[], required — Claims the tool trajectory does not support. - `gateWaiver` GateWaiver — An audited, time-boxed override of an eval run's release gate. A waiver never changes the run's own `result` — the run keeps its verdict and every surface that honors the waiver says so out loud, which is what makes "no silent waiver" checkable rather than promised. - `id` string, required - `suiteId` string, required - `runId` string, nullable, required — The run this waiver covers. Suite-wide waivers are not honored. - `reason` string, required — Why the gate was overridden, as the granter wrote it. Stored UNREDACTED and readable by anyone who can see the suite, for as long as the suite exists — never put secrets, tokens, or customer data in it. - `expiresAt` integer, required — Epoch ms. Always in the future when granted, and capped at 30 days out — there is no permanent waiver. - `createdAt` integer, required - `createdBy` string, required - `createdByEmail` string, nullable, required — `null`, never absent, when it cannot be resolved — a deleted user must not make a waiver look authorless. - `revokedAt` integer, nullable, required - `revokedBy` string, nullable, required - `active` boolean, required — Whether it is in force right now — neither revoked nor expired. Computed at read time; a client that must not honor a lapsed waiver should re-derive it from `expiresAt` rather than trust it. - `policySnapshot` object, nullable, required — WHAT was overridden, captured at waive time so a later edit to the suite cannot rewrite the record. `null` for a run decided by the v2 verdict policy, whose identity is recorded on the audit event instead — this shape cannot hold it, and filling it in would be a false record rather than an incomplete one. - `minimumPassRate` number, required - `importEligibility` ImportEligibility — Whether a run's imported cases carry evidence a gate may rely on. Computed by the platform from the run's OWN frozen snapshot, never from the suite's current cases — recomputing from those would let a later edit change what a finished run is allowed to prove. `legacy` means the run contains no imported cases at all (every native run, forever) and is gateable unchanged; `eligible` means every imported case carries a valid frozen decision; `incomplete` means the evidence cannot be trusted, which makes the run NOT GATEABLE and is not a test verdict. The whole field is ABSENT on deployments that predate import eligibility — a different fact from `legacy`, and one a gate must read as "no opinion, behave as before". - `status` 'legacy' | 'eligible' | 'incomplete', required - `gateable` boolean, required - `importedCaseCount` integer, required - `claimedExactCaseIds` string[], required - `approvedApproximationCaseIds` string[], required - `approvedApproximationReceipts` ImportApprovalReceipt[], required - `testCaseId` string, required - `caseKey` string - `sourceCaseKey` string - `approvedBy` string, required — Server-derived approver id. - `approvedAt` integer, required — Server-derived epoch milliseconds. - `reason` string, required - `issues` ImportEligibilityIssue[], required - `code` string, required — Stable machine-readable code. - `testCaseId` string - `caseKey` string - `toolName` string - `name` string - `tags` string[] - `runMetadata` object — Bounded caller metadata; preserved as descriptive data, never authorization. - `ciMetadata` object — Bounded CI attribution and source revision metadata. - `runEvaluationsByCase` object[] — Case-scoped run evaluator observations with source and definition identity. ## Other responses - `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. - `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. ## Changes - **2026-09-21** `ee79c934cffb` — 2 warning - added the new `analysisUnavailable` enum value to the `items/items/insights/allOf[#/components/schemas/InsightsEnvelope]/journeyFindings/allOf[#/components/schemas/SwarmJourneyFindings]/coverageNotes/items/` response property for the response status `200` - added the new `analysisUnavailable` enum value to the `items/items/insights/allOf[#/components/schemas/InsightsEnvelope]/journeyFindings/allOf[#/components/schemas/SwarmJourneyFindings]/findings/items/coverageNotes/items/` response property for the response status `200` - …earlier changes not shown [Full history](https://skmtc.dev/mcpjam/apis/mcpjam-api/changes/projects/:projectId/eval-suites/:suiteId/runs/get.md) --- [API](https://skmtc.dev/mcpjam/apis/mcpjam-api.md) · [All operations](https://skmtc.dev/mcpjam/apis/mcpjam-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mcpjam/apis/mcpjam-api/revisions/a15a9864fb85?raw)