MatrixColumnPatch
Change one column, including whether it is conditional on another. **Changing `question`, `columnType` or `options` BLANKS every cell in this column.** `MatrixService.update_column` bulk-resets them to pending with a null answer, no citations and no `answer_data`, which destroys a manually edited or approved answer and the verifier's verdict along with it. That is defensible in a browser where a human just typed the new question and is looking at the grid; it is not something a PATCH should do silently, which is why it is stated in each of those three field descriptions and not only here. A generated client shows the field description. `label` and `instructions` do not reset anything: they change how the column reads and what guidance it carries, not what was asked.
Properties
| Name | Type | Description |
|---|---|---|
| label | object | New column heading. Resets nothing. |
| question | object | New question for this column. WARNING: changing it clears every existing answer in this column, including answers a human wrote or approved and any verification verdict on them, and leaves the cells u |
| columnType | object | New answer shape: `free_text`, `single_select`, `date`, `money`, `yes_no` or `party_name`. WARNING: changing it clears every existing answer in this column, as changing the question does. |
| options | object | New allowed answers for a `single_select` column. WARNING: changing them clears every existing answer in this column, as changing the question does. |
| instructions | object | New extractor guidance scoped to this column. Resets nothing. |
| dependsOnColumnId | object | `col_` identifier of a column in this same matrix that this one becomes conditional on, or null to make it unconditional again. A cycle is refused. |
| gateExpression | object | The condition on the upstream answer that has to hold for this column to run, or null to run whenever the dependency has answered. One of `any`, `not_empty`, `yes`, `no`, `yes_no:yes`, `yes_no:no`, `e |
| injectUpstream | object | True prepends the upstream column's answer to this column's prompt, so the question can refer to it. False asks the question on its own. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-matrix-column-patch-schema.json",
"title": "MatrixColumnPatch",
"description": "Change one column, including whether it is conditional on another.\n\n**Changing `question`, `columnType` or `options` BLANKS every cell in this\ncolumn.** `MatrixService.update_column` bulk-resets them to pending with a\nnull answer, no citations and no `answer_data`, which destroys a manually\nedited or approved answer and the verifier's verdict along with it. That is\ndefensible in a browser where a human just typed the new question and is\nlooking at the grid; it is not something a PATCH should do silently, which is\nwhy it is stated in each of those three field descriptions and not only\nhere. A generated client shows the field description.\n\n`label` and `instructions` do not reset anything: they change how the column\nreads and what guidance it carries, not what was asked.",
"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/MatrixColumnPatch",
"properties": {
"label": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Label",
"description": "New column heading. Resets nothing."
},
"question": {
"anyOf": [
{
"type": "string",
"maxLength": 4000,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Question",
"description": "New question for this column. WARNING: changing it clears every existing answer in this column, including answers a human wrote or approved and any verification verdict on them, and leaves the cells unanswered until the next run."
},
"columnType": {
"anyOf": [
{
"type": "string",
"enum": [
"free_text",
"single_select",
"date",
"money",
"yes_no",
"party_name"
]
},
{
"type": "null"
}
],
"title": "Columntype",
"description": "New answer shape: `free_text`, `single_select`, `date`, `money`, `yes_no` or `party_name`. WARNING: changing it clears every existing answer in this column, as changing the question does."
},
"options": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Options",
"description": "New allowed answers for a `single_select` column. WARNING: changing them clears every existing answer in this column, as changing the question does."
},
"instructions": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
],
"title": "Instructions",
"description": "New extractor guidance scoped to this column. Resets nothing."
},
"dependsOnColumnId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Dependsoncolumnid",
"description": "`col_` identifier of a column in this same matrix that this one becomes conditional on, or null to make it unconditional again. A cycle is refused."
},
"gateExpression": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"pattern": "^(any|not_empty|yes|no|yes_no:(?:yes|no)|equals:.+|in:.+)$"
},
{
"type": "null"
}
],
"title": "Gateexpression",
"description": "The condition on the upstream answer that has to hold for this column to run, or null to run whenever the dependency has answered. One of `any`, `not_empty`, `yes`, `no`, `yes_no:yes`, `yes_no:no`, `equals:VALUE` or `in:A|B|C`. Anything else is refused: an expression we cannot parse would mark every cell in the column as deliberately skipped with no error anywhere. `yes`, `no` and `equals:` match the WHOLE upstream answer, not part of it, so they belong on a `yes_no` or `single_select` upstream column; over a `free_text` one, use `not_empty`."
},
"injectUpstream": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Injectupstream",
"description": "True prepends the upstream column's answer to this column's prompt, so the question can refer to it. False asks the question on its own."
}
},
"additionalProperties": false,
"type": "object"
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/vaquill-ai-matrix-column-patch"
curl "https://apis.io/api/v1/json-schemas?limit=25"
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.
A second provider on the same verified email joins the account you already have.