{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/arpi-ai/json-schema/arpi-ai-ai-comment-response-schema.json",
  "title": "AiCommentResponse",
  "description": "AI Comment (LLM) result. HTTP status is always 200 — read the status field.",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/arpi-ai-openapi.json#/components/schemas/AiCommentResponse",
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string",
      "description": "Job ID"
    },
    "status": {
      "type": "string",
      "description": "AI comment availability. READY = markdown present; PENDING = not generated yet (keep polling); UNSUPPORTED = not applicable (not v2, submitted with aicmnt=false, or job failed).",
      "enum": [
        "READY",
        "PENDING",
        "UNSUPPORTED"
      ]
    },
    "lang": {
      "type": [
        "string",
        "null"
      ],
      "description": "Resolved language of the returned section. Null unless READY.",
      "enum": [
        "ko",
        "en"
      ]
    },
    "markdown": {
      "type": [
        "string",
        "null"
      ],
      "description": "AI comment markdown for the requested language. Null unless READY."
    }
  },
  "required": [
    "jobId",
    "status"
  ]
}