Input Schema
{
"bodyFields": {
"classification_only": {
"description": "true => simple classification (lowest tier $1)",
"required": false,
"type": "boolean"
},
"has_source_docs": {
"description": "true => source documents attached for cross-verification (raises tier)",
"required": false,
"type": "boolean"
},
"question": {
"description": "Korea-specific question/matter to judge",
"required": true,
"type": "string"
},
"title": {
"description": "Short subject (optional)",
"required": false,
"type": "string"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
}
Output Schema
{
"description": "KPN judgment JSON, retrieved by polling status_url with the issued token (202 generating -> 200 done). Machine-readable.",
"properties": {
"auditId": {
"type": "string"
},
"auditVerifyUrl": {
"description": "GET to machine-re-verify the judgment (sources, committee DIDs, dimensions)",
"type": "string"
},
"businessRisk": {
"enum": [
"Low",
"Medium",
"High"
],
"type": "string"
},
"citations": {
"description": "[{title,url,grade,official:boolean}]",
"type": "array"
},
"conclusion": {
"description": "{ lead, body }",
"type": "object"
},
"confidence": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"confidence_grade": {
"description": "Verification confidence (trust axis)",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"decision": {
"description": "Overall judgment",
"enum": [
"go",
"conditional_go",
"no_go"
],
"type": "string"
},
"decisionByIssue": {
"description": "[{issue, verdict: STOP|HOLD|CONDITIONAL_GO, reason}] per-issue judgment",
"type": "array"
},
"hold": {
"description": "true = HOLD (below send threshold) — do NOT treat as a confident GO",
"type": "boolean"
},
"needsVerification": {
"description": "Unverified variables separated out — KPN does not assert these (e.g. ROI/success-rate go here, not as numbers)",
"type": "array"
},
"officialSourceRatio": {
"description": "0-1 official-source ratio",
"type": "number"
},
"policy_ruleset": {
"description": "Machine rules[]; derived rules carry derived:true + derived_from (honesty: not a model-authored judgment). rules_status: model_authored | derived_from_block | derived_from_conclusion | none_derivable",
"type": "object"
},
"requiredActions": {
"description": "Immediate actions",
"type": "array"
},
"risk_grade": {
"description": "Business risk axis",
"enum": [
"Low",
"Medium",
"High"
],
"type": "string"
},
"sources": {
"description": "Cited sources (url, title, grade)",
"type": "array"
},
"tier": {
"enum": [
"classification",
"committee",
"deep"
],
"type": "string"
},
"trustDimensions": {
"description": "{A,C,E,V} actual computed dimensions (no fabrication)",
"type": "object"
},
"trustScore": {
"description": "0-100 (alias of trust_score)",
"type": "number"
},
"trust_score": {
"description": "0-100 committee cross-verification trust",
"type": "number"
},
"verdict_label": {
"type": "string"
}
},
"type": "object"
}