Klineo/Docs
Open app ↗

API schemas

ValidatedHealthReport

All API schemas

object — Additional properties rejected

Field Required at this level Type Description and constraints
schemaVersion Yes Constant agent-health-report-v1 —
organizationId Yes string Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$
runId Yes string Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$
captureHash Yes string Pattern: ^0x[0-9a-f]{64}$
sourceCutoff Yes string Format: date-time
capturedAt Yes string Format: date-time
window Yes object Additional properties rejected
window.start Yes string Format: date-time
window.end Yes string Format: date-time
baselineWindow Yes object Additional properties rejected
baselineWindow.start Yes string Format: date-time
baselineWindow.end Yes string Format: date-time
status Yes string Allowed: PARTIAL, ABSTAINED
marketHealth Yes Constant NOT_ASSESSED —
title Yes string —
findings Yes Array of HealthClaim Max items: 32
comparisons Yes Array of HealthMetricComparison Max items: 4
marketQuality Yes Array of HealthMarketQualityCheck Max items: 200
hypotheses Yes Array of object Max items: 6
hypotheses[].hypothesisId Yes string Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$
hypotheses[].rank Yes integer Minimum: 1; Maximum: 6
hypotheses[].label Yes Constant UNVERIFIED_HYPOTHESIS —
hypotheses[].explanation Yes string Min length: 10; Max length: 1200
hypotheses[].supportingClaims Yes Array of HealthClaim Max items: 8
hypotheses[].contradictingClaims Yes Array of HealthClaim Max items: 8
hypotheses[].uncertainty Yes string Min length: 10; Max length: 800
hypotheses[].warning Yes string —
coverage Yes Array of HealthCoverageGroup Max items: 16
gaps Yes Array of string —
nextChecks Yes Array of object Max items: 5
nextChecks[].kind Yes string Allowed: REVIEW_POLICY, REVIEW_ACTIVITY, REVIEW_INCIDENTS, CHECK_DATA_HEALTH, EXPLORE_RESEARCH_DRAFT
nextChecks[].label Yes string —
nextChecks[].destination Yes string Allowed: POLICY, ACTIVITY, INCIDENTS, DATA_HEALTH, RESEARCH_SETUP
nextChecks[].execution Yes Constant MANUAL_NAVIGATION_ONLY —
validation Yes object Additional properties rejected
validation.version Yes Constant health-report-validator-v1 —
validation.checkedClaimCount Yes integer Minimum: 0; Maximum: 9007199254740991
validation.recordedClaimCount Yes integer Minimum: 0; Maximum: 9007199254740991
validation.availableClaimCount Yes integer Minimum: 0; Maximum: 9007199254740991
validation.hypothesisSemanticsVerified Yes Constant false —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Exact definition: #/components/schemas/ValidatedHealthReport in the OpenAPI contract.