@jinshuju/mcp 0.2.0 → 0.4.0

package/dist/generated/tools.json

@@ -15,12 +15,14 @@
             {
                 "name": "filters",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "sort",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "next",
@@ -67,12 +69,112 @@
                     "description": "Fuzzy match on name (case-insensitive; matches both the public name and the in-product name). Accepts several values (`q[]=A&q[]=B`), matching forms whose name contains any of them. Equivalent to `filters=[{\"field\":\"form_name\",\"operator\":\"like\",\"value\":...}]`."
                 },
                 "filters": {
-                    "type": "string",
-                    "description": "Filters, a JSON array; conditions are combined with AND. Filterable fields and operators:\n| field | type | operators |\n|---|---|---|\n| `form_name` | text | `eq` `ne` `any_in` `none_in` `like` `not_like` |\n| `created_at` | time | `eq` `ne` `gte` `gt` `lte` `lt` `within_last` |\n| `last_entry_created_at` | time | same as above (forms that have never received an entry have no value) |\n| `entries_count` | integer | `eq` `ne` `gte` `gt` `lte` `lt` |\n\nThe value of `within_last` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month), meaning the window going back from now.\nExample: `[{\"field\":\"last_entry_created_at\",\"operator\":\"within_last\",\"value\":{\"unit\":\"day\",\"n\":7}}]`\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "description": "One filter condition. A `filters` parameter is the JSON text of an array of these, combined with AND; each endpoint says which fields and operators it takes.",
+                        "required": [
+                            "operator"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "What to filter on; a field api_code for entries, or a form attribute such as `created_at` for form lists. Required unless the deprecated `api_code` or `trigger` is given instead."
+                            },
+                            "api_code": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "trigger": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "operator": {
+                                "type": "string",
+                                "enum": [
+                                    "eq",
+                                    "ne",
+                                    "any_in",
+                                    "none_in",
+                                    "between",
+                                    "not_between",
+                                    "null",
+                                    "not_null",
+                                    "gte",
+                                    "gt",
+                                    "lte",
+                                    "lt",
+                                    "like",
+                                    "not_like",
+                                    "within_last",
+                                    "equal",
+                                    "not_equal",
+                                    "start",
+                                    "end"
+                                ],
+                                "description": "Comparison; `equal` / `not_equal` / `start` / `end` are aliases of `eq` / `ne` / `gte` / `lte`. Each field type accepts only some operators, and an unsupported one returns 400 listing the available ones."
+                            },
+                            "value": {
+                                "description": "Condition value; its type depends on the field and the operator: a two-element array `[min, max]` for `between` / `not_between`, `{\"unit\": \"day\", \"n\": 30}` for `within_last`, and no value for `null` / `not_null`."
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "entries_count",
+                                "operator": "gte",
+                                "value": 1
+                            }
+                        ]
+                    ],
+                    "description": "Filters, an array of ScopeCondition objects; conditions are combined with AND. Filterable fields and operators:\n| field | type | operators |\n|---|---|---|\n| `form_name` | text | `eq` `ne` `any_in` `none_in` `like` `not_like` |\n| `created_at` | time | `eq` `ne` `gte` `gt` `lte` `lt` `within_last` |\n| `last_entry_created_at` | time | same as above (forms that have never received an entry have no value) |\n| `entries_count` | integer | `eq` `ne` `gte` `gt` `lte` `lt` |\n\nThe value of `within_last` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month), meaning the window going back from now.\nExample: `[{\"field\":\"last_entry_created_at\",\"operator\":\"within_last\",\"value\":{\"unit\":\"day\",\"n\":7}}]`\n"
                 },
                 "sort": {
-                    "type": "string",
-                    "description": "Sort rules, a JSON array, each item `{\"field\": \"<field>\", \"order\": \"asc\"|\"desc\"}` (order defaults to asc), applied in order.\nSortable fields: `created_at`, `last_entry_created_at`, `entries_count`; any other field, an invalid order or unparseable JSON returns 400.\nWith `sort`, `next` becomes a cursor of the form `row:<offset>`, usable only in requests with the same `sort`; rows with equal values may change order between pages.\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "field"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "enum": [
+                                    "created_at",
+                                    "last_entry_created_at",
+                                    "entries_count"
+                                ],
+                                "description": "Form attribute to sort by"
+                            },
+                            "order": {
+                                "type": "string",
+                                "enum": [
+                                    "asc",
+                                    "desc"
+                                ],
+                                "default": "asc",
+                                "description": "Sort direction"
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "last_entry_created_at",
+                                "order": "desc"
+                            }
+                        ]
+                    ],
+                    "description": "Sort rules, an array of FormSortRule objects, applied in order.\nSortable fields: `created_at`, `last_entry_created_at`, `entries_count`; any other field, an invalid order or unparseable JSON returns 400.\nWith `sort`, `next` becomes a cursor of the form `row:<offset>`, usable only in requests with the same `sort`; rows with equal values may change order between pages.\n"
                 },
                 "next": {
                     "type": "string",
@@ -107,7 +209,7 @@
     {
         "operationId": "getForm",
         "summary": "Show a form's structure",
-        "description": "Show a form's structure\nReturns the form's name, public fill URL (`url`), description, field definitions and settings. Each element of `fields` is a single-key object `{ \"<api_code>\": {...} }`, in field order.\nThe following are included when the matching parameter is `true`:\n- `include_analytics`: each analysable field's definition carries `analytics`;\n- `include_theme`: carries `theme` (the form theme);\n- `include_field_rules`: carries `field_rules` (field display rules);\n- `include_extended_attributes`: carries `extended_attributes` (source-tracking links);\n- `include_transactions`: carries `transactions` (payment statistics) when the form is bound to a payment account.\nReturns schema \"FormDetail\" (see get_schema).\nThe api_code of each field in the returned fields is its key when reading and writing entries.",
+        "description": "Show a form's structure\nReturns the form's name, `kind`, `scene`, public URL (`url`), description, field definitions and settings. Each element of `fields` is a single-key object `{ \"<api_code>\": {...} }`, in field order.\nAlso answers for a table or a quick payment form token; `kind` says which it is.\nThe following are included when the matching parameter is `true`:\n- `include_analytics`: each analysable field's definition carries `analytics`;\n- `include_theme`: carries `theme` (the form theme);\n- `include_field_rules`: carries `field_rules` (field display rules);\n- `include_extended_attributes`: carries `extended_attributes` (source-tracking links);\n- `include_transactions`: carries `transactions` (payment statistics) when the form is bound to a payment account.\nReturns schema \"FormDetail\" (see get_schema).\nThe api_code of each field in the returned fields is its key when reading and writing entries.",
         "tag": "Forms",
         "method": "get",
         "path": "/forms/{form_token}",
@@ -206,7 +308,7 @@
     {
         "operationId": "createForm",
         "summary": "Create a form",
-        "description": "Create a form\nCreates a form from a list of field definitions and returns the full form structure. `name` and `fields` are required.\n- `scene` sets the form's scene; exam / evaluation question types (such as `SingleSelect`, `FillInBlank`) can only be used in the scenes that support them.\n- `layout=card` (paged) does not support PageBreak, Matrix*, TableField, GoodsField, ESignatureField, FormAssociation, MultipleBlanksField or any kind of Widget field.\n- The folder named by `folder_token` must be manageable and of kind form; otherwise returns 404 / 400 respectively.\n- `setting` accepts only whitelisted keys (see `FormSettingWriteInput`); `setting.notification_rules` replaces, as a whole, the notification rules created through the API.\n- The returned form structure carries `url` (the public fill URL).\nReturns schema \"Form\" (see get_schema).\nEach item of fields branches on type: get_schema(\"FieldInput\") lists the types, then get_schema(\"<Type>Input\") (e.g. \"TextFieldInput\") shows the properties that type accepts; do not guess field properties. For an exam or evaluation form use create_exam_form / create_evaluation_form.",
+        "description": "Create a form\nCreates a form from a list of field definitions and returns the full form structure. `name` and `fields` are required.\n- `scene` sets the form's scene; exam / evaluation question types (such as `SingleSelect`, `FillInBlank`) can only be used in the scenes that support them.\n- `layout=card` (paged) does not support PageBreak, Matrix*, TableField, GoodsField, ESignatureField, FormAssociation, MultipleBlanksField or any kind of Widget field.\n- The folder named by `folder_token` must be manageable and of kind form; otherwise returns 404 / 400 respectively.\n- `setting` accepts only whitelisted keys (see `FormSettingWriteInput`); `setting.notification_rules` replaces, as a whole, the notification rules created through the API.\n- The returned form structure carries `url` (the public fill URL).\nReturns schema \"Form\" (see get_schema).\nEach item of fields branches on type: get_schema(\"FieldInput\") maps each type to its schema in x-variants (TextField → \"TextFieldInput\", SingleSelect → \"SingleSelectInput\"), and get_schema on that name shows the properties that type accepts; do not guess field properties or schema names. For an exam or evaluation form use create_exam_form / create_evaluation_form.",
         "tag": "Forms",
         "method": "post",
         "path": "/forms",
@@ -702,6 +804,11 @@
                 "folder_token": {
                     "type": "string",
                     "description": "Target folder token or id; when omitted, the copy is not put in a folder"
+                },
+                "with_notification_rules": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Copy the notification rules too; takes manage permission on the source form, and copies none when the caller is outside the source form creator's account"
                 }
             },
             "additionalProperties": false,
@@ -716,6 +823,60 @@
             "openWorldHint": false
         }
     },
+    {
+        "operationId": "deleteForm",
+        "summary": "Delete a form",
+        "description": "Delete a form\nMoves the form and its entries to the trash, from which the product can restore it; on success, returns the form token.",
+        "tag": "Forms",
+        "method": "delete",
+        "path": "/forms/{form_token}",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "forms"
+        ],
+        "name": "delete_form",
+        "title": "Delete a form",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "form_token": {
+                    "type": "string",
+                    "description": "Form token (`token` from `GET /forms`); a 24-character hexadecimal form id is also accepted."
+                }
+            },
+            "additionalProperties": false,
+            "required": [
+                "form_token"
+            ]
+        },
+        "outputSchema": {
+            "type": "object",
+            "required": [
+                "token"
+            ],
+            "properties": {
+                "token": {
+                    "type": "string"
+                }
+            }
+        },
+        "annotations": {
+            "readOnlyHint": false,
+            "destructiveHint": true,
+            "idempotentHint": true,
+            "openWorldHint": false
+        }
+    },
     {
         "operationId": "moveFormToFolder",
         "summary": "Move a form into a folder",
@@ -934,7 +1095,8 @@
             {
                 "name": "checks",
                 "in": "query",
-                "required": true
+                "required": true,
+                "json": true
             }
         ],
         "paramNames": [
@@ -956,8 +1118,63 @@
                     "description": "Form token (`token` from `GET /forms`); a 24-character hexadecimal form id is also accepted."
                 },
                 "checks": {
-                    "type": "string",
-                    "description": "Targets to check, a JSON array (1 to 100 items), each item one field or one choice:\n| Key | Type | Description |\n|---|---|---|\n| `field_api_code` | string | Required. api_code of the field to check; to check one column of a table field / matrix field, pass that column's api_code and also pass `parent_field` |\n| `choice_value` | string | Optional. To check only one choice, pass that choice's api_code; omitted, checks whether the whole field has any data |\n| `choice_type` | string | Optional, used with `choice_value`: `choice` (default), `statement` / `dimension` for matrix fields, `level_1` to `level_4` for cascading drop-downs |\n| `parent_field` | string | Optional. When checking one column of a matrix / table field, the api_code of the parent field |\n| `check_extended_text` | boolean | Optional. When `true`, checks whether the choice's \"Other\" extra text has any data |\n| `goods_item_dimension_options` | object | Optional. When checking one spec of a goods field, the mapping of spec dimensions to options |\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "field_api_code"
+                        ],
+                        "properties": {
+                            "field_api_code": {
+                                "type": "string",
+                                "description": "api_code of the field to check; to check one column of a table / matrix field, that column's api_code, with `parent_field` set"
+                            },
+                            "choice_value": {
+                                "type": "string",
+                                "description": "api_code of one choice to check; omitted, checks whether the whole field has any data"
+                            },
+                            "choice_type": {
+                                "type": "string",
+                                "enum": [
+                                    "choice",
+                                    "statement",
+                                    "dimension",
+                                    "level_1",
+                                    "level_2",
+                                    "level_3",
+                                    "level_4"
+                                ],
+                                "description": "What `choice_value` names, `choice` by default; `statement` / `dimension` for matrix fields, `level_1` to `level_4` for cascading drop-downs"
+                            },
+                            "parent_field": {
+                                "type": "string",
+                                "description": "api_code of the parent field when checking one column of a matrix / table field"
+                            },
+                            "check_extended_text": {
+                                "type": "boolean",
+                                "description": "When true, checks whether the choice's \"Other\" extra text has any data"
+                            },
+                            "goods_item_dimension_options": {
+                                "type": "object",
+                                "description": "When checking one spec of a goods field, the mapping of spec dimensions to options"
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field_api_code": "field_1"
+                            },
+                            {
+                                "field_api_code": "field_3",
+                                "choice_value": "Yb2d"
+                            }
+                        ]
+                    ],
+                    "description": "Targets to check, an array of 1 to 100 FieldDataCheck objects, each naming one field or one choice."
                 }
             },
             "additionalProperties": false,
@@ -989,7 +1206,8 @@
             {
                 "name": "checks",
                 "in": "query",
-                "required": true
+                "required": true,
+                "json": true
             }
         ],
         "paramNames": [
@@ -1011,8 +1229,46 @@
                     "description": "Form token (`token` from `GET /forms`); a 24-character hexadecimal form id is also accepted."
                 },
                 "checks": {
-                    "type": "string",
-                    "description": "Type conversions to preview, a JSON array (1 to 20 items), one field per item:\n| Key | Type | Description |\n|---|---|---|\n| `field_api_code` | string | Required. api_code of the field to convert |\n| `target_type` | string | Required. Target field type; see `GET /field_types` for values (`GET /field_types?kind=table` for tables) |\n| `target_precision` | string | Optional. When the target is `DateTimeField`, the date precision the edit will use (`month` / `day` / `minute` / `second`), so the preview matches the actual conversion; ignored otherwise |\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "field_api_code",
+                            "target_type"
+                        ],
+                        "properties": {
+                            "field_api_code": {
+                                "type": "string",
+                                "description": "api_code of the field to convert"
+                            },
+                            "target_type": {
+                                "type": "string",
+                                "description": "Target field type; see `GET /field_types` for the values (`GET /field_types?kind=table` for tables)"
+                            },
+                            "target_precision": {
+                                "type": "string",
+                                "enum": [
+                                    "month",
+                                    "day",
+                                    "minute",
+                                    "second"
+                                ],
+                                "description": "When the target is `DateTimeField`, the date precision the edit will use, so the preview matches the actual conversion; ignored otherwise"
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field_api_code": "field_1",
+                                "target_type": "RadioButton"
+                            }
+                        ]
+                    ],
+                    "description": "Type conversions to preview, an array of 1 to 20 FieldTypeChangeCheck objects, one field per item."
                 }
             },
             "additionalProperties": false,
@@ -1103,12 +1359,14 @@
             {
                 "name": "fields",
                 "in": "query",
-                "required": false
+                "required": false,
+                "array": true
             },
             {
                 "name": "filters",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "keyword",
@@ -1118,7 +1376,8 @@
             {
                 "name": "sort",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "created_at",
@@ -1173,12 +1432,84 @@
                     "description": "Form token (`token` from `GET /forms`); a 24-character hexadecimal form id is also accepted."
                 },
                 "fields": {
-                    "type": "string",
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "string"
+                    },
                     "description": "Return only these fields. A JSON array, a comma-separated string or a repeated parameter, of field api_codes; the serial number is always returned. Returns 400 listing the available fields when an api_code is unknown."
                 },
                 "filters": {
-                    "type": "string",
-                    "description": "Filters, a JSON array of `{\"field\": \"<api_code>\", \"operator\": \"<op>\", \"value\": ...}` items (`field` can also be written as `api_code` / `trigger`); conditions are combined with AND.\n- All operators: `eq` `ne` `any_in` `none_in` `between` `not_between` `null` `not_null` `gte` `gt` `lte` `lt` `like` `not_like` `within_last`,\n  aliases `equal` / `not_equal` / `start` (=gte) / `end` (=lte). Each field type accepts only some of them; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "description": "One filter condition. A `filters` parameter is the JSON text of an array of these, combined with AND; each endpoint says which fields and operators it takes.",
+                        "required": [
+                            "operator"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "What to filter on; a field api_code for entries, or a form attribute such as `created_at` for form lists. Required unless the deprecated `api_code` or `trigger` is given instead."
+                            },
+                            "api_code": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "trigger": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "operator": {
+                                "type": "string",
+                                "enum": [
+                                    "eq",
+                                    "ne",
+                                    "any_in",
+                                    "none_in",
+                                    "between",
+                                    "not_between",
+                                    "null",
+                                    "not_null",
+                                    "gte",
+                                    "gt",
+                                    "lte",
+                                    "lt",
+                                    "like",
+                                    "not_like",
+                                    "within_last",
+                                    "equal",
+                                    "not_equal",
+                                    "start",
+                                    "end"
+                                ],
+                                "description": "Comparison; `equal` / `not_equal` / `start` / `end` are aliases of `eq` / `ne` / `gte` / `lte`. Each field type accepts only some operators, and an unsupported one returns 400 listing the available ones."
+                            },
+                            "value": {
+                                "description": "Condition value; its type depends on the field and the operator: a two-element array `[min, max]` for `between` / `not_between`, `{\"unit\": \"day\", \"n\": 30}` for `within_last`, and no value for `null` / `not_null`."
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "field_3",
+                                "operator": "any_in",
+                                "value": [
+                                    "选项 A",
+                                    "选项 B"
+                                ]
+                            }
+                        ]
+                    ],
+                    "description": "Filters, an array of ScopeCondition objects; conditions are combined with AND.\n- Each field type accepts only some of the operators; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
                 },
                 "keyword": {
                     "type": "string",
@@ -1186,8 +1517,40 @@
                     "description": "Full-text keyword (at most 200 characters), fuzzy-matched across all searchable fields. Forms with more than 99999 entries and no analytics engine enabled do not support full-text search (returns 400), unless `creator_id` also restricts the submitter."
                 },
                 "sort": {
-                    "type": "string",
-                    "description": "Sort rules, a JSON array of `{\"api_code\": \"<api_code>\", \"order\": \"asc\"|\"desc\"}` items, applied in order, with ascending serial number appended automatically at the end.\nOnly sortable fields are allowed; otherwise returns 400 listing the sortable fields. With `sort`, `next` becomes a row offset.\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "api_code"
+                        ],
+                        "properties": {
+                            "api_code": {
+                                "type": "string",
+                                "description": "api_code of the field to sort by; only sortable fields are allowed"
+                            },
+                            "order": {
+                                "type": "string",
+                                "enum": [
+                                    "asc",
+                                    "desc"
+                                ],
+                                "default": "asc",
+                                "description": "Sort direction"
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "api_code": "created_at",
+                                "order": "desc"
+                            }
+                        ]
+                    ],
+                    "description": "Sort rules, an array of SortRule objects, applied in order, with ascending serial number appended automatically at the end.\nOnly sortable fields are allowed; otherwise returns 400 listing the sortable fields. With `sort`, `next` becomes a row offset.\n"
                 },
                 "created_at": {
                     "type": "string",
@@ -1283,7 +1646,8 @@
             {
                 "name": "fields",
                 "in": "query",
-                "required": false
+                "required": false,
+                "array": true
             },
             {
                 "name": "include_labels",
@@ -1316,7 +1680,13 @@
                     "description": "Entry serial number"
                 },
                 "fields": {
-                    "type": "string",
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "string"
+                    },
                     "description": "Return only these fields. A JSON array, a comma-separated string or a repeated parameter, of field api_codes; the serial number is always returned. Returns 400 listing the available fields when an api_code is unknown."
                 },
                 "include_labels": {
@@ -1819,12 +2189,14 @@
             {
                 "name": "metrics",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "dimensions",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "limit",
@@ -1834,7 +2206,8 @@
             {
                 "name": "filters",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "keyword",
@@ -1865,12 +2238,94 @@
                     "description": "Form token (`token` from `GET /forms`); a 24-character hexadecimal form id is also accepted."
                 },
                 "metrics": {
-                    "type": "string",
-                    "description": "Required. Metrics to compute, a JSON array of 1 to 20 items, each `{\"func\": \"<function>\", \"field\": \"<api_code>\"}`; returns 400 when missing or empty.\nThe available functions depend on the field (the field's `analytics.agg_funcs` is authoritative):\n| Field | Functions |\n|---|---|\n| All fields | `count` `count_non_empty` `count_empty` |\n| Text | adds `count_unique` |\n| Number | adds `count_unique` `sum` `avg` `min` `max` `stddev` `median` `p25` `p75` `p90` |\n| Date | adds `count_unique` `min` `max` |\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "func",
+                            "field"
+                        ],
+                        "properties": {
+                            "func": {
+                                "type": "string",
+                                "enum": [
+                                    "count",
+                                    "count_non_empty",
+                                    "count_empty",
+                                    "count_unique",
+                                    "sum",
+                                    "avg",
+                                    "min",
+                                    "max",
+                                    "stddev",
+                                    "median",
+                                    "p25",
+                                    "p75",
+                                    "p90"
+                                ],
+                                "description": "Aggregate function; the field's `analytics.agg_funcs` says which ones it supports"
+                            },
+                            "field": {
+                                "type": "string",
+                                "description": "api_code of the field to aggregate"
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "func": "sum",
+                                "field": "field_5"
+                            },
+                            {
+                                "func": "count",
+                                "field": "field_1"
+                            }
+                        ]
+                    ],
+                    "description": "Required. Metrics to compute, an array of 1 to 20 AggregateMetric objects; returns 400 when missing or empty.\nThe available functions depend on the field (the field's `analytics.agg_funcs` is authoritative):\n| Field | Functions |\n|---|---|\n| All fields | `count` `count_non_empty` `count_empty` |\n| Text | adds `count_unique` |\n| Number | adds `count_unique` `sum` `avg` `min` `max` `stddev` `median` `p25` `p75` `p90` |\n| Date | adds `count_unique` `min` `max` |\n"
                 },
                 "dimensions": {
-                    "type": "string",
-                    "description": "Fields to group by, a JSON array of at most 2 items, each `{\"field\": \"<api_code>\", \"bucket\": \"<granularity>\"}`.\nOnly fields whose `analytics.groupable` is true can be grouped by; a date field must have a `bucket` (`day` / `week` / `month`, in Beijing time, UTC+8), and a non-date field must not have a `bucket`.\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "field"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "api_code of the field to group by; only fields whose `analytics.groupable` is true"
+                            },
+                            "bucket": {
+                                "type": "string",
+                                "enum": [
+                                    "day",
+                                    "week",
+                                    "month"
+                                ],
+                                "description": "Time granularity, required for a date field and not allowed on any other"
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "field_3"
+                            },
+                            {
+                                "field": "created_at",
+                                "bucket": "month"
+                            }
+                        ]
+                    ],
+                    "description": "Fields to group by, an array of at most 2 AggregateDimension objects.\nOnly fields whose `analytics.groupable` is true can be grouped by; a date field must have a `bucket` (`day` / `week` / `month`, in Beijing time, UTC+8), and a non-date field must not have a `bucket`.\n"
                 },
                 "limit": {
                     "type": "integer",
@@ -1878,8 +2333,74 @@
                     "description": "Maximum number of groups returned when grouping. Defaults to 20, max 200 (larger values are treated as 200; values below 1 use the default). Ignored without grouping."
                 },
                 "filters": {
-                    "type": "string",
-                    "description": "Filters, a JSON array of `{\"field\": \"<api_code>\", \"operator\": \"<op>\", \"value\": ...}` items (`field` can also be written as `api_code` / `trigger`); conditions are combined with AND.\n- All operators: `eq` `ne` `any_in` `none_in` `between` `not_between` `null` `not_null` `gte` `gt` `lte` `lt` `like` `not_like` `within_last`,\n  aliases `equal` / `not_equal` / `start` (=gte) / `end` (=lte). Each field type accepts only some of them; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "description": "One filter condition. A `filters` parameter is the JSON text of an array of these, combined with AND; each endpoint says which fields and operators it takes.",
+                        "required": [
+                            "operator"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "What to filter on; a field api_code for entries, or a form attribute such as `created_at` for form lists. Required unless the deprecated `api_code` or `trigger` is given instead."
+                            },
+                            "api_code": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "trigger": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "operator": {
+                                "type": "string",
+                                "enum": [
+                                    "eq",
+                                    "ne",
+                                    "any_in",
+                                    "none_in",
+                                    "between",
+                                    "not_between",
+                                    "null",
+                                    "not_null",
+                                    "gte",
+                                    "gt",
+                                    "lte",
+                                    "lt",
+                                    "like",
+                                    "not_like",
+                                    "within_last",
+                                    "equal",
+                                    "not_equal",
+                                    "start",
+                                    "end"
+                                ],
+                                "description": "Comparison; `equal` / `not_equal` / `start` / `end` are aliases of `eq` / `ne` / `gte` / `lte`. Each field type accepts only some operators, and an unsupported one returns 400 listing the available ones."
+                            },
+                            "value": {
+                                "description": "Condition value; its type depends on the field and the operator: a two-element array `[min, max]` for `between` / `not_between`, `{\"unit\": \"day\", \"n\": 30}` for `within_last`, and no value for `null` / `not_null`."
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "field_3",
+                                "operator": "any_in",
+                                "value": [
+                                    "选项 A",
+                                    "选项 B"
+                                ]
+                            }
+                        ]
+                    ],
+                    "description": "Filters, an array of ScopeCondition objects; conditions are combined with AND.\n- Each field type accepts only some of the operators; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
                 },
                 "keyword": {
                     "type": "string",
@@ -1915,7 +2436,8 @@
             {
                 "name": "fields",
                 "in": "query",
-                "required": false
+                "required": false,
+                "array": true
             },
             {
                 "name": "include_overview",
@@ -1925,7 +2447,8 @@
             {
                 "name": "filters",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "keyword",
@@ -1955,7 +2478,13 @@
                     "description": "Form token (`token` from `GET /forms`); a 24-character hexadecimal form id is also accepted."
                 },
                 "fields": {
-                    "type": "string",
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "string"
+                    },
                     "description": "Summarize only these fields: field api_codes, comma-separated (or repeat `fields[]=`), returned in the order given. Defaults to every analyzable field. Returns 400, listing the analyzable fields, when a field is not analyzable or the caller has no permission to read it."
                 },
                 "include_overview": {
@@ -1964,8 +2493,74 @@
                     "description": "Whether to return `overview` (matching count and entries added today). Defaults to true."
                 },
                 "filters": {
-                    "type": "string",
-                    "description": "Filters, a JSON array of `{\"field\": \"<api_code>\", \"operator\": \"<op>\", \"value\": ...}` items (`field` can also be written as `api_code` / `trigger`); conditions are combined with AND.\n- All operators: `eq` `ne` `any_in` `none_in` `between` `not_between` `null` `not_null` `gte` `gt` `lte` `lt` `like` `not_like` `within_last`,\n  aliases `equal` / `not_equal` / `start` (=gte) / `end` (=lte). Each field type accepts only some of them; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "description": "One filter condition. A `filters` parameter is the JSON text of an array of these, combined with AND; each endpoint says which fields and operators it takes.",
+                        "required": [
+                            "operator"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "What to filter on; a field api_code for entries, or a form attribute such as `created_at` for form lists. Required unless the deprecated `api_code` or `trigger` is given instead."
+                            },
+                            "api_code": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "trigger": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "operator": {
+                                "type": "string",
+                                "enum": [
+                                    "eq",
+                                    "ne",
+                                    "any_in",
+                                    "none_in",
+                                    "between",
+                                    "not_between",
+                                    "null",
+                                    "not_null",
+                                    "gte",
+                                    "gt",
+                                    "lte",
+                                    "lt",
+                                    "like",
+                                    "not_like",
+                                    "within_last",
+                                    "equal",
+                                    "not_equal",
+                                    "start",
+                                    "end"
+                                ],
+                                "description": "Comparison; `equal` / `not_equal` / `start` / `end` are aliases of `eq` / `ne` / `gte` / `lte`. Each field type accepts only some operators, and an unsupported one returns 400 listing the available ones."
+                            },
+                            "value": {
+                                "description": "Condition value; its type depends on the field and the operator: a two-element array `[min, max]` for `between` / `not_between`, `{\"unit\": \"day\", \"n\": 30}` for `within_last`, and no value for `null` / `not_null`."
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "field_3",
+                                "operator": "any_in",
+                                "value": [
+                                    "选项 A",
+                                    "选项 B"
+                                ]
+                            }
+                        ]
+                    ],
+                    "description": "Filters, an array of ScopeCondition objects; conditions are combined with AND.\n- Each field type accepts only some of the operators; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
                 },
                 "keyword": {
                     "type": "string",
@@ -2001,12 +2596,14 @@
             {
                 "name": "form_tokens",
                 "in": "query",
-                "required": false
+                "required": false,
+                "array": true
             },
             {
                 "name": "filters",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             }
         ],
         "paramNames": [
@@ -2030,12 +2627,84 @@
                     "description": "Search keyword (at most 200 characters); returns 400 when empty."
                 },
                 "form_tokens": {
-                    "type": "string",
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "string"
+                    },
                     "description": "Tokens (ids also accepted) of the forms or tables to search, comma-separated (or repeat `form_tokens[]=`), at most 10 after deduplication. When omitted, every accessible form is searched."
                 },
                 "filters": {
-                    "type": "string",
-                    "description": "Filters on form attributes that narrow the search scope, a JSON array with the same syntax and fields as `filters` of `GET /forms` (`form_name` / `created_at` / `last_entry_created_at` / `entries_count`); conditions are combined with AND.\nWithout an `entries_count` condition, `entries_count > 0` is appended automatically.\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "description": "One filter condition. A `filters` parameter is the JSON text of an array of these, combined with AND; each endpoint says which fields and operators it takes.",
+                        "required": [
+                            "operator"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "What to filter on; a field api_code for entries, or a form attribute such as `created_at` for form lists. Required unless the deprecated `api_code` or `trigger` is given instead."
+                            },
+                            "api_code": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "trigger": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "operator": {
+                                "type": "string",
+                                "enum": [
+                                    "eq",
+                                    "ne",
+                                    "any_in",
+                                    "none_in",
+                                    "between",
+                                    "not_between",
+                                    "null",
+                                    "not_null",
+                                    "gte",
+                                    "gt",
+                                    "lte",
+                                    "lt",
+                                    "like",
+                                    "not_like",
+                                    "within_last",
+                                    "equal",
+                                    "not_equal",
+                                    "start",
+                                    "end"
+                                ],
+                                "description": "Comparison; `equal` / `not_equal` / `start` / `end` are aliases of `eq` / `ne` / `gte` / `lte`. Each field type accepts only some operators, and an unsupported one returns 400 listing the available ones."
+                            },
+                            "value": {
+                                "description": "Condition value; its type depends on the field and the operator: a two-element array `[min, max]` for `between` / `not_between`, `{\"unit\": \"day\", \"n\": 30}` for `within_last`, and no value for `null` / `not_null`."
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "last_entry_created_at",
+                                "operator": "within_last",
+                                "value": {
+                                    "unit": "day",
+                                    "n": 30
+                                }
+                            }
+                        ]
+                    ],
+                    "description": "Filters on form attributes that narrow the search scope, an array of ScopeCondition objects, with the same fields as `filters` of `GET /forms` (`form_name` / `created_at` / `last_entry_created_at` / `entries_count`); conditions are combined with AND.\nWithout an `entries_count` condition, `entries_count > 0` is appended automatically.\n"
                 }
             },
             "additionalProperties": false,
@@ -2224,12 +2893,14 @@
             {
                 "name": "fields",
                 "in": "query",
-                "required": false
+                "required": false,
+                "array": true
             },
             {
                 "name": "filters",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "keyword",
@@ -2282,12 +2953,84 @@
                     "description": "Form token (`token` from `GET /my/forms`); a 24-character hexadecimal form id is also accepted."
                 },
                 "fields": {
-                    "type": "string",
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "string"
+                    },
                     "description": "Return only these fields. A comma-separated string or an array parameter (`fields[]=`) of field api_codes; unknown or non-public fields are skipped. The serial number is always returned."
                 },
                 "filters": {
-                    "type": "string",
-                    "description": "Filters, a JSON array of `{\"field\": \"<api_code>\", \"operator\": \"<op>\", \"value\": ...}` items (`field` can also be written as `api_code` / `trigger`); conditions are combined with AND.\n- All operators: `eq` `ne` `any_in` `none_in` `between` `not_between` `null` `not_null` `gte` `gt` `lte` `lt` `like` `not_like` `within_last`,\n  aliases `equal` / `not_equal` / `start` (=gte) / `end` (=lte). Each field type accepts only some of them; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "description": "One filter condition. A `filters` parameter is the JSON text of an array of these, combined with AND; each endpoint says which fields and operators it takes.",
+                        "required": [
+                            "operator"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "What to filter on; a field api_code for entries, or a form attribute such as `created_at` for form lists. Required unless the deprecated `api_code` or `trigger` is given instead."
+                            },
+                            "api_code": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "trigger": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "operator": {
+                                "type": "string",
+                                "enum": [
+                                    "eq",
+                                    "ne",
+                                    "any_in",
+                                    "none_in",
+                                    "between",
+                                    "not_between",
+                                    "null",
+                                    "not_null",
+                                    "gte",
+                                    "gt",
+                                    "lte",
+                                    "lt",
+                                    "like",
+                                    "not_like",
+                                    "within_last",
+                                    "equal",
+                                    "not_equal",
+                                    "start",
+                                    "end"
+                                ],
+                                "description": "Comparison; `equal` / `not_equal` / `start` / `end` are aliases of `eq` / `ne` / `gte` / `lte`. Each field type accepts only some operators, and an unsupported one returns 400 listing the available ones."
+                            },
+                            "value": {
+                                "description": "Condition value; its type depends on the field and the operator: a two-element array `[min, max]` for `between` / `not_between`, `{\"unit\": \"day\", \"n\": 30}` for `within_last`, and no value for `null` / `not_null`."
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "field_3",
+                                "operator": "any_in",
+                                "value": [
+                                    "选项 A",
+                                    "选项 B"
+                                ]
+                            }
+                        ]
+                    ],
+                    "description": "Filters, an array of ScopeCondition objects; conditions are combined with AND.\n- Each field type accepts only some of the operators; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
                 },
                 "keyword": {
                     "type": "string",
@@ -2378,7 +3121,8 @@
             {
                 "name": "form_tokens",
                 "in": "query",
-                "required": false
+                "required": false,
+                "array": true
             }
         ],
         "paramNames": [
@@ -2401,7 +3145,13 @@
                     "description": "Search keyword (at most 200 characters), fuzzy-matched in the form's public searchable fields."
                 },
                 "form_tokens": {
-                    "type": "string",
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "string"
+                    },
                     "description": "Search only these forms. Comma-separated form tokens, or an array parameter (`form_tokens[]=`)."
                 }
             },
@@ -3286,12 +4036,14 @@
             {
                 "name": "filters",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "sort",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "next",
@@ -3332,12 +4084,112 @@
                     "description": "Fuzzy match on name (case-insensitive; matches both the public name and the in-product name). Accepts several values (`q[]=A&q[]=B`), matching forms whose name contains any of them. Equivalent to `filters=[{\"field\":\"form_name\",\"operator\":\"like\",\"value\":...}]`."
                 },
                 "filters": {
-                    "type": "string",
-                    "description": "Filters, a JSON array; conditions are combined with AND. Filterable fields and operators:\n| field | type | operators |\n|---|---|---|\n| `form_name` | text | `eq` `ne` `any_in` `none_in` `like` `not_like` |\n| `created_at` | time | `eq` `ne` `gte` `gt` `lte` `lt` `within_last` |\n| `last_entry_created_at` | time | same as above (forms that have never received an entry have no value) |\n| `entries_count` | integer | `eq` `ne` `gte` `gt` `lte` `lt` |\n\nThe value of `within_last` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month), meaning the window going back from now.\nExample: `[{\"field\":\"last_entry_created_at\",\"operator\":\"within_last\",\"value\":{\"unit\":\"day\",\"n\":7}}]`\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "description": "One filter condition. A `filters` parameter is the JSON text of an array of these, combined with AND; each endpoint says which fields and operators it takes.",
+                        "required": [
+                            "operator"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "What to filter on; a field api_code for entries, or a form attribute such as `created_at` for form lists. Required unless the deprecated `api_code` or `trigger` is given instead."
+                            },
+                            "api_code": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "trigger": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "operator": {
+                                "type": "string",
+                                "enum": [
+                                    "eq",
+                                    "ne",
+                                    "any_in",
+                                    "none_in",
+                                    "between",
+                                    "not_between",
+                                    "null",
+                                    "not_null",
+                                    "gte",
+                                    "gt",
+                                    "lte",
+                                    "lt",
+                                    "like",
+                                    "not_like",
+                                    "within_last",
+                                    "equal",
+                                    "not_equal",
+                                    "start",
+                                    "end"
+                                ],
+                                "description": "Comparison; `equal` / `not_equal` / `start` / `end` are aliases of `eq` / `ne` / `gte` / `lte`. Each field type accepts only some operators, and an unsupported one returns 400 listing the available ones."
+                            },
+                            "value": {
+                                "description": "Condition value; its type depends on the field and the operator: a two-element array `[min, max]` for `between` / `not_between`, `{\"unit\": \"day\", \"n\": 30}` for `within_last`, and no value for `null` / `not_null`."
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "entries_count",
+                                "operator": "gte",
+                                "value": 1
+                            }
+                        ]
+                    ],
+                    "description": "Filters, an array of ScopeCondition objects; conditions are combined with AND. Filterable fields and operators:\n| field | type | operators |\n|---|---|---|\n| `form_name` | text | `eq` `ne` `any_in` `none_in` `like` `not_like` |\n| `created_at` | time | `eq` `ne` `gte` `gt` `lte` `lt` `within_last` |\n| `last_entry_created_at` | time | same as above (forms that have never received an entry have no value) |\n| `entries_count` | integer | `eq` `ne` `gte` `gt` `lte` `lt` |\n\nThe value of `within_last` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month), meaning the window going back from now.\nExample: `[{\"field\":\"last_entry_created_at\",\"operator\":\"within_last\",\"value\":{\"unit\":\"day\",\"n\":7}}]`\n"
                 },
                 "sort": {
-                    "type": "string",
-                    "description": "Sort rules, a JSON array, each item `{\"field\": \"<field>\", \"order\": \"asc\"|\"desc\"}` (order defaults to asc), applied in order.\nSortable fields: `created_at`, `last_entry_created_at`, `entries_count`; any other field, an invalid order or unparseable JSON returns 400.\nWith `sort`, `next` becomes a cursor of the form `row:<offset>`, usable only in requests with the same `sort`; rows with equal values may change order between pages.\n"
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "field"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "enum": [
+                                    "created_at",
+                                    "last_entry_created_at",
+                                    "entries_count"
+                                ],
+                                "description": "Form attribute to sort by"
+                            },
+                            "order": {
+                                "type": "string",
+                                "enum": [
+                                    "asc",
+                                    "desc"
+                                ],
+                                "default": "asc",
+                                "description": "Sort direction"
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "last_entry_created_at",
+                                "order": "desc"
+                            }
+                        ]
+                    ],
+                    "description": "Sort rules, an array of FormSortRule objects, applied in order.\nSortable fields: `created_at`, `last_entry_created_at`, `entries_count`; any other field, an invalid order or unparseable JSON returns 400.\nWith `sort`, `next` becomes a cursor of the form `row:<offset>`, usable only in requests with the same `sort`; rows with equal values may change order between pages.\n"
                 },
                 "next": {
                     "type": "string",
@@ -4368,7 +5220,7 @@
     {
         "operationId": "getCurrentUser",
         "summary": "Show the current user",
-        "description": "Show the current user\nReturns the user behind the current credential. With an account-level credential (no specific user), returns the account owner.",
+        "description": "Show the current user\nReturns the user behind the current credential. With an account-level credential (no specific user), returns the account owner.\nReturns schema \"CurrentUser\" (see get_schema).",
         "tag": "Account",
         "method": "get",
         "path": "/me",
@@ -4386,64 +5238,6 @@
             "properties": {},
             "additionalProperties": false
         },
-        "outputSchema": {
-            "type": "object",
-            "required": [
-                "id",
-                "name",
-                "email",
-                "mobile",
-                "role",
-                "billing_account_id",
-                "created_at"
-            ],
-            "properties": {
-                "id": {
-                    "type": "string",
-                    "description": "User ID"
-                },
-                "name": {
-                    "type": [
-                        "string",
-                        "null"
-                    ],
-                    "description": "Display name"
-                },
-                "email": {
-                    "type": [
-                        "string",
-                        "null"
-                    ],
-                    "description": "Email"
-                },
-                "mobile": {
-                    "type": [
-                        "string",
-                        "null"
-                    ],
-                    "description": "Mobile number"
-                },
-                "role": {
-                    "type": "string",
-                    "enum": [
-                        "owner",
-                        "admin",
-                        "worker",
-                        "outworker"
-                    ],
-                    "description": "Role in the account"
-                },
-                "billing_account_id": {
-                    "type": "string",
-                    "description": "ID of the account the user belongs to"
-                },
-                "created_at": {
-                    "type": "string",
-                    "format": "date-time",
-                    "description": "Signed up at (UTC)"
-                }
-            }
-        },
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -5004,7 +5798,7 @@
     {
         "operationId": "createForm",
         "summary": "Create a form",
-        "description": "Creates an online exam form (scene=exam, scored automatically). Use it, not create_form, when the user wants an exam, test or quiz; an evaluation such as a psychological test, ability assessment, self-assessment questionnaire or training feedback uses create_evaluation_form. Questions must use exam question types (SingleSelect / MultiSelect / TrueOrFalse / DropDownSelect / FillInBlank / ShortAnswer / FillInNumber), each with answers (the correct answer and its score; the default absolute mode has one correct answer and scores only a fully correct response). Creates the form first, then applies exam_setting; if the settings are rejected, the form already exists and the result says so.\nCreates a form from a list of field definitions and returns the full form structure. `name` and `fields` are required.\n- `scene` sets the form's scene; exam / evaluation question types (such as `SingleSelect`, `FillInBlank`) can only be used in the scenes that support them.\n- `layout=card` (paged) does not support PageBreak, Matrix*, TableField, GoodsField, ESignatureField, FormAssociation, MultipleBlanksField or any kind of Widget field.\n- The folder named by `folder_token` must be manageable and of kind form; otherwise returns 404 / 400 respectively.\n- `setting` accepts only whitelisted keys (see `FormSettingWriteInput`); `setting.notification_rules` replaces, as a whole, the notification rules created through the API.\n- The returned form structure carries `url` (the public fill URL).",
+        "description": "Creates an online exam form (scene=exam, scored automatically). Use it, not create_form, when the user wants an exam, test or quiz; an evaluation such as a psychological test, ability assessment, self-assessment questionnaire or training feedback uses create_evaluation_form. Questions must use exam question types (SingleSelect / MultiSelect / TrueOrFalse / DropDownSelect / FillInBlank / ShortAnswer / FillInNumber), each with answers (the correct answer and its score; the default absolute mode has one correct answer and scores only a fully correct response). A question type's schema is the one FieldInput's x-variants names (SingleSelect → \"SingleSelectInput\"; see get_schema). Creates the form first, then applies exam_setting; if the settings are rejected, the form already exists and the result says so.\nCreates a form from a list of field definitions and returns the full form structure. `name` and `fields` are required.\n- `scene` sets the form's scene; exam / evaluation question types (such as `SingleSelect`, `FillInBlank`) can only be used in the scenes that support them.\n- `layout=card` (paged) does not support PageBreak, Matrix*, TableField, GoodsField, ESignatureField, FormAssociation, MultipleBlanksField or any kind of Widget field.\n- The folder named by `folder_token` must be manageable and of kind form; otherwise returns 404 / 400 respectively.\n- `setting` accepts only whitelisted keys (see `FormSettingWriteInput`); `setting.notification_rules` replaces, as a whole, the notification rules created through the API.\n- The returned form structure carries `url` (the public fill URL).",
         "tag": "Forms",
         "method": "post",
         "path": "/forms",
@@ -5573,7 +6367,7 @@
     {
         "operationId": "createForm",
         "summary": "Create a form",
-        "description": "Creates an evaluation form (scene=evaluation). Use it when the user wants an evaluation, psychological test, ability assessment, self-assessment questionnaire or training feedback; not create_form, and not create_exam_form (an exam with correct answers). A scored evaluation uses SingleSelect / MultiSelect / DropDownSelect / Rating / Nps: each question lists every choice with its score in answers and sets answer_setting_mode=relative (every choice scores, none is right or wrong; the default absolute accepts one correct answer and scores any other choice 0). Do not score with a regular choice field's calculable / operand_value. A feedback questionnaire uses regular fields (RatingField / MatrixScaleField / TextArea, etc.) without scores. Creates the form first, then applies evaluation_setting (the report after submission, comments by total score range, dimensions).\nCreates a form from a list of field definitions and returns the full form structure. `name` and `fields` are required.\n- `scene` sets the form's scene; exam / evaluation question types (such as `SingleSelect`, `FillInBlank`) can only be used in the scenes that support them.\n- `layout=card` (paged) does not support PageBreak, Matrix*, TableField, GoodsField, ESignatureField, FormAssociation, MultipleBlanksField or any kind of Widget field.\n- The folder named by `folder_token` must be manageable and of kind form; otherwise returns 404 / 400 respectively.\n- `setting` accepts only whitelisted keys (see `FormSettingWriteInput`); `setting.notification_rules` replaces, as a whole, the notification rules created through the API.\n- The returned form structure carries `url` (the public fill URL).",
+        "description": "Creates an evaluation form (scene=evaluation). Use it when the user wants an evaluation, psychological test, ability assessment, self-assessment questionnaire or training feedback; not create_form, and not create_exam_form (an exam with correct answers). A scored evaluation uses SingleSelect / MultiSelect / DropDownSelect / Rating / Nps: each question lists every choice with its score in answers and sets answer_setting_mode=relative (every choice scores, none is right or wrong; the default absolute accepts one correct answer and scores any other choice 0). A question type's schema is the one FieldInput's x-variants names (SingleSelect → \"SingleSelectInput\"; see get_schema). Do not score with a regular choice field's calculable / operand_value. A feedback questionnaire uses regular fields (RatingField / MatrixScaleField / TextArea, etc.) without scores. Creates the form first, then applies evaluation_setting (the report after submission, comments by total score range, dimensions).\nCreates a form from a list of field definitions and returns the full form structure. `name` and `fields` are required.\n- `scene` sets the form's scene; exam / evaluation question types (such as `SingleSelect`, `FillInBlank`) can only be used in the scenes that support them.\n- `layout=card` (paged) does not support PageBreak, Matrix*, TableField, GoodsField, ESignatureField, FormAssociation, MultipleBlanksField or any kind of Widget field.\n- The folder named by `folder_token` must be manageable and of kind form; otherwise returns 404 / 400 respectively.\n- `setting` accepts only whitelisted keys (see `FormSettingWriteInput`); `setting.notification_rules` replaces, as a whole, the notification rules created through the API.\n- The returned form structure carries `url` (the public fill URL).",
         "tag": "Forms",
         "method": "post",
         "path": "/forms",
@@ -6051,7 +6845,8 @@
             {
                 "name": "filters",
                 "in": "query",
-                "required": false
+                "required": false,
+                "json": true
             },
             {
                 "name": "keyword",
@@ -6086,8 +6881,74 @@
                     "description": "A form token, or an array of up to 10 tokens to count several forms in one call"
                 },
                 "filters": {
-                    "type": "string",
-                    "description": "Filters, a JSON array of `{\"field\": \"<api_code>\", \"operator\": \"<op>\", \"value\": ...}` items (`field` can also be written as `api_code` / `trigger`); conditions are combined with AND.\n- All operators: `eq` `ne` `any_in` `none_in` `between` `not_between` `null` `not_null` `gte` `gt` `lte` `lt` `like` `not_like` `within_last`,\n  aliases `equal` / `not_equal` / `start` (=gte) / `end` (=lte). Each field type accepts only some of them; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
+                    "type": [
+                        "array",
+                        "string"
+                    ],
+                    "items": {
+                        "type": "object",
+                        "description": "One filter condition. A `filters` parameter is the JSON text of an array of these, combined with AND; each endpoint says which fields and operators it takes.",
+                        "required": [
+                            "operator"
+                        ],
+                        "properties": {
+                            "field": {
+                                "type": "string",
+                                "description": "What to filter on; a field api_code for entries, or a form attribute such as `created_at` for form lists. Required unless the deprecated `api_code` or `trigger` is given instead."
+                            },
+                            "api_code": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "trigger": {
+                                "type": "string",
+                                "deprecated": true,
+                                "description": "Deprecated alias of `field`; use `field`."
+                            },
+                            "operator": {
+                                "type": "string",
+                                "enum": [
+                                    "eq",
+                                    "ne",
+                                    "any_in",
+                                    "none_in",
+                                    "between",
+                                    "not_between",
+                                    "null",
+                                    "not_null",
+                                    "gte",
+                                    "gt",
+                                    "lte",
+                                    "lt",
+                                    "like",
+                                    "not_like",
+                                    "within_last",
+                                    "equal",
+                                    "not_equal",
+                                    "start",
+                                    "end"
+                                ],
+                                "description": "Comparison; `equal` / `not_equal` / `start` / `end` are aliases of `eq` / `ne` / `gte` / `lte`. Each field type accepts only some operators, and an unsupported one returns 400 listing the available ones."
+                            },
+                            "value": {
+                                "description": "Condition value; its type depends on the field and the operator: a two-element array `[min, max]` for `between` / `not_between`, `{\"unit\": \"day\", \"n\": 30}` for `within_last`, and no value for `null` / `not_null`."
+                            }
+                        }
+                    },
+                    "examples": [
+                        [
+                            {
+                                "field": "field_3",
+                                "operator": "any_in",
+                                "value": [
+                                    "选项 A",
+                                    "选项 B"
+                                ]
+                            }
+                        ]
+                    ],
+                    "description": "Filters, an array of ScopeCondition objects; conditions are combined with AND.\n- Each field type accepts only some of the operators; an unsupported one returns 400 listing the available operators.\n- For choice fields (single choice / multiple choice / drop-down / cascading drop-down), `value` can be a choice api_code or a choice label; a cascading drop-down also accepts a `level1-level2` path.\n- For `between` / `not_between`, `value` is a two-element array `[min, max]`; matrix / table fields need `{\"<column api_code>\": [min, max]}`.\n- `within_last` works only on date fields; `value` looks like `{\"unit\":\"day\",\"n\":30}` (unit can be minute / day / week / month).\n- `creator_id` is a special field that filters by submitter with `eq` (the value is a user id), and can appear only once.\n- `serial_number` is a special field that filters by serial number with `eq` / `any_in`; several conditions are intersected.\n- For a relation field (RelationField), the `value` of `any_in` / `none_in` is serial numbers of entries in the related table; returns 400 when a serial number does not exist.\n- With a `created_at` condition, results are sorted by creation time instead.\n- To find entries whose multiple-choice field contains a choice, use `any_in` (`none_in` to exclude); `eq` is not \"contains\": it matches only entries with exactly the same set of choices."
                 },
                 "keyword": {
                     "type": "string",