{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-matrix-cell-patch-schema.json",
  "title": "MatrixCellPatch",
  "description": "Write a human answer into a cell, or record a review decision on it.\n\nWriting `answer` promotes the cell to an edited state, and **an edited,\napproved or rejected cell is not re-run and not re-charged by a default\nrun.** `MatrixService._select_cells_for_run` selects only `pending`,\n`error`, `not_found` and `not_applicable`, `schedule_run` re-applies that\nfilter on its bulk reset, and `extract_cell_by_id` short-circuits before any\nmodel call. `force: true` on a run has none of those guards and overwrites\nthe answer with no warning.\n\nThe cell keeps reading as `succeeded`, because the extraction job did\nsucceed. The review verdict is not published back on the cell for the same\nreason the comments and decisions are not published at all: it is a\ncollaboration primitive, and this API publishes the five public statuses and\nno sixth.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vaquill-ai-matrices-api-openapi.yml#/components/schemas/MatrixCellPatch",
  "properties": {
    "answer": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 20000,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Answer",
      "description": "The answer to record for this cell, replacing whatever is there. There is no way to clear an answer back to empty; re-run the cell with `force` to have the extractor produce a fresh one."
    },
    "review": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "approved",
            "rejected"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Review",
      "description": "`approved` or `rejected`, recording what a reviewer decided about the answer. The extractor's own statuses cannot be written here: an integration writing `extracted` onto an answer no machine produced makes the grid unauditable."
    }
  },
  "additionalProperties": false,
  "type": "object"
}