Write a human answer into a cell, or record a review decision on it. Writing `answer` promotes the cell to an edited state, and **an edited, approved or rejected cell is not re-run and not re-charged by a default run.** `MatrixService._select_cells_for_run` selects only `pending`, `error`, `not_found` and `not_applicable`, `schedule_run` re-applies that filter on its bulk reset, and `extract_cell_by_id` short-circuits before any model call. `force: true` on a run has none of those guards and overwrites the answer with no warning. The cell keeps reading as `succeeded`, because the extraction job did succeed. The review verdict is not published back on the cell for the same reason the comments and decisions are not published at all: it is a collaboration primitive, and this API publishes the five public statuses and no sixth.
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
object
`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
{
"$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"
}
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.