Klineo/Docs
Open app ↗

API schemas

CandidateReviewReport

All API schemas

object — Additional properties rejected

Field Required at this level Type Description and constraints
schemaVersion Yes Constant agent-candidate-review-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}$
reviewScope Yes Constant RESEARCH_CANDIDATE_EVIDENCE —
status Yes Constant PARTIAL —
captureHash Yes string Pattern: ^0x[0-9a-f]{64}$
sourceCutoff Yes string Format: date-time; Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
reviewedAt Yes string Format: date-time; Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
reviewedCandidate Yes object Additional properties rejected
reviewedCandidate.packId Yes string Pattern: ^decisionpack_[a-f0-9]{32}$
reviewedCandidate.resourceVersion Yes string Pattern: ^0x[0-9a-f]{64}$
reviewedCandidate.contentHash Yes string Pattern: ^0x[0-9a-f]{64}$
checks Yes Array of object Max items: 16
checks[].id Yes string Max length: 100
checks[].status Yes string Allowed: RECORDED_PASS, RECORDED_FAIL, UNAVAILABLE
checks[].detail Yes string Max length: 1200
findings Yes Array of object Max items: 24
findings[].id Yes string Pattern: ^finding-[a-z0-9-]+$
findings[].summary Yes string Max length: 1200
findings[].evidenceIds Yes Array of string Max items: 8
trialReferences Yes Array of object Min items: 1; Max items: 4
trialReferences[].kind Yes Constant RESEARCH_TRIAL —
trialReferences[].runId Yes string Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$
trialReferences[].protocolHash Yes string Pattern: ^0x[0-9a-f]{64}$
trialReferences[].trialKey Yes string Allowed: baseline, alternative-1, alternative-2, alternative-3
trialReferences[].inputHash Yes string Pattern: ^0x[0-9a-f]{64}$
trialReferences[].artifactHash Yes At least one of: string; null —
trialReferences[].state Yes string Allowed: QUEUED, RUNNING, COMPLETED, FAILED, CANCELLED
trialReferences[].recordedAt Yes At least one of: string; null —
trialReferences[].failureCode Yes At least one of: string; null —
costs Yes Array of object Min items: 6; Max items: 6
costs[].category Yes string Allowed: GAS, INCENTIVE, PLATFORM_FEE, CAPITAL_LOSS, VENUE_FEE, SLIPPAGE
costs[].status Yes Constant UNAVAILABLE —
costs[].amountAtomic Yes null —
costs[].reason Yes string Max length: 1200
gaps Yes Array of string Max items: 24
nextChecks Yes Array of string Max items: 5
approvalAuthorityGranted Yes Constant false —
executionAuthorityGranted Yes Constant false —
publicationAuthorityGranted 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/CandidateReviewReport in the OpenAPI contract.