Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-21161224637.5 KB

8978a4e735fa

Directory readiness

Read one readiness run

Lane statuses, coverage and the observation axis. The full report — every finding with its citation and provenance — is a separate fetch.

get/projects/{projectId}/readiness-runs/{runId}

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

runIdstring required

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

Response

The run.

idstring required
readinessKind'claude' | 'openai' required
serverIdstring nullable required

The saved project server this run graded. Null only on rows written before the field existed.

serverUrlstring required

The saved server's URL exactly as stored. Canonicalizing it would change the grade.

submissionMode'mcp-only' | 'mcp-imported-skills' nullable required

The declared submission shape, for an OpenAI run. Never inferred.

status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' required

cancelled is distinct from failed: a person who stopped a run has learned nothing about their server.

overallStatus'ready' | 'not-ready' | 'incomplete' nullable required

The headline verdict. incomplete means nothing was violated and something the run needed was never evaluated.

authMode'headless' | 'interactive' | 'provided-token' nullable required
capabilitiesstring[] required

What the executing surface could actually do. Two surfaces grading one target agree only on their shared capability subset.

attemptCountinteger required
terminalReasonstring nullable required
errorMessagestring nullable required
policySnapshotDatestring nullable required

The publisher-documentation snapshot this run graded against, so a stale grade says so.

engineVersionstring nullable required
sdkVersionstring nullable required
includeLlmObservationsboolean required

Whether this run was started with the paid observation opt-in.

hasReportboolean required
reportUrlstring nullable required
createdAtinteger required
updatedAtinteger required