@jinshuju/mcp 0.4.0 → 0.5.0

package/dist/generated/operations.json

@@ -63,7 +63,7 @@
     "createForm": {
         "operationId": "createForm",
         "summary": "Create a form",
-        "description": "Creates 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 a form from a list of field definitions and returns the full form structure.",
         "tag": "Forms",
         "method": "post",
         "path": "/forms",
@@ -83,7 +83,7 @@
     "getForm": {
         "operationId": "getForm",
         "summary": "Show a form's structure",
-        "description": "Returns 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.",
+        "description": "Returns 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.",
         "tag": "Forms",
         "method": "get",
         "path": "/forms/{form_token}",
@@ -215,7 +215,7 @@
     "checkFormFieldData": {
         "operationId": "checkFormFieldData",
         "summary": "Check whether fields already hold data",
-        "description": "Use before deleting a field or choice: checks in batch whether fields (or single choices of a field) already have submitted entries. Deleting a field or choice that still has entries deletes those entries with it, and they cannot be recovered.\nMatches the check the web editor runs before deleting.\n- Put every deletion target of one edit in the `checks` of a single call (at most 100, may span several fields); `results` matches `checks` one to one, in order.\n- When a target cannot be checked (for example, the field does not exist), its row returns `unavailable` with the reason; the other targets return as usual.\n- Returns 400 when `checks` is missing, empty, over 100, not a JSON array, or has an item that is not an object.",
+        "description": "Use before deleting a field or choice: checks in batch whether fields (or single choices of a field) already have submitted entries. Deleting a field or choice that still has entries deletes those entries with it, and they cannot be recovered.\nMatches the check the web editor runs before deleting.\n- Put every deletion target of one edit in the `checks` of a single call (at most 100, may span several fields); `results` matches `checks` one to one, in order.\n- When a target cannot be checked (the field or the `parent_field` column does not exist, or `choice_value` matches nothing of the kind `choice_type` names, or names more than one), its row returns `unavailable` with the reason; the other targets return as usual.\n- Returns 400 when `checks` is missing, empty, over 100, not a JSON array, or has an item that is not an object.",
         "tag": "Forms",
         "method": "get",
         "path": "/forms/{form_token}/fields/check",
@@ -245,7 +245,7 @@
     "previewFormFieldTypeChange": {
         "operationId": "previewFormFieldTypeChange",
         "summary": "Preview a field type change",
-        "description": "Use before changing a field's type (the field's `type` in PATCH /forms/{form_token}): changes no data, and counts, from the field's current entries, how many would be kept and how many cleared after the conversion.\nThe conversion happens on the original field (api_code and data column unchanged), so only entry data is affected; matches the preview the web editor shows before converting.\n- Put every conversion of one edit in the `checks` of a single call (at most 20); `results` matches `checks` one to one, in order.\n- `supported=false` means the field cannot be converted to the target type, and the actual edit is refused too.\n- When converting multi-line text to a choice field such as single choice / multiple choice, also returns `choice_count`, the number of choices that would be generated from existing entries, and `choice_limit_exceeded`, whether that exceeds the choice limit (when it does, the conversion is refused rather than truncated).\n- When an item cannot be previewed (the field does not exist, `target_type` is not a type available to this form, etc.), its row returns `unavailable` with the reason; the other items return as usual.\n- Returns 400 when `checks` is missing, empty, over 20, not a JSON array, or has an item that is not an object.",
+        "description": "Use before changing a field's type (the field's `type` in PATCH /forms/{form_token}): changes no data, and counts, from the field's current entries, how many would be kept and how many cleared after the conversion; matches the preview the web editor shows before converting.\n- Put every conversion of one edit in the `checks` of a single call.\n- `supported: false`, or `choice_limit_exceeded: true` when multi-line text becomes a choice field, means the edit itself would be refused.",
         "tag": "Forms",
         "method": "get",
         "path": "/forms/{form_token}/fields/preview_convert",
@@ -420,7 +420,7 @@
     "aggregateEntries": {
         "operationId": "aggregateEntries",
         "summary": "Aggregate entries",
-        "description": "Aggregates whole columns on the server over the entries matching the filters (sum, average, count, percentiles, etc.), optionally grouped by 1 to 2 fields. The response size depends only on the number of metrics and groups, not on the amount of data.\n- `metrics` is required, 1 to 20 items; the functions each field takes are in the `analytics.agg_funcs` returned by `GET /forms/{form_token}?include_analytics=true`.\n- `dimensions` is optional, at most 2 items; only fields whose `analytics.groupable` is true (single-value choice fields and date fields) can be grouped by, and a date field must specify `bucket`.\n- Without `dimensions`, `rows` has a single row; when grouped, one row per group, at most `limit` groups; `row_count` is the total number of groups, and `truncated` is true when there are more.\n- `filters` / `keyword` are the same as for the entry list, but `creator_id`, `serial_number` and association field conditions are not supported (returns 400).\n- Returns 400 when a field does not exist or is not readable by the caller, or a function or grouping does not apply to the field, and says which fields / functions / groupings are available.",
+        "description": "Aggregates whole columns on the server over the entries matching the filters (sum, average, count, percentiles, etc.), optionally grouped by 1 to 2 fields. The response size depends only on the number of metrics and groups, not on the amount of data.\n- `filters` / `keyword` work as in the entry list, except that `creator_id`, `serial_number` and association field conditions are not supported.",
         "tag": "Entries",
         "method": "get",
         "path": "/forms/{form_token}/entries/aggregate",
@@ -1229,10 +1229,218 @@
             "form_setting"
         ]
     },
+    "listNotificationRules": {
+        "operationId": "listNotificationRules",
+        "summary": "List notification rules",
+        "description": "Lists the form's notification rules, newest first, each with whether it can send right now.",
+        "tag": "Form Settings",
+        "method": "get",
+        "path": "/forms/{form_token}/notification_rules",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "form_setting"
+        ]
+    },
+    "createNotificationRule": {
+        "operationId": "createNotificationRule",
+        "summary": "Create a notification rule",
+        "description": "Creates a notification rule; the body follows the schema of its `approach`. The rule sends for matching entries from then on, using the SMS / email balance, and shows on the form's notification settings page. SMS and WeChat messages are reviewed when they are sent.\n- Saving an enabled `schedule_time` rule also schedules the entries already in the form whose send time is still ahead.",
+        "tag": "Form Settings",
+        "method": "post",
+        "path": "/forms/{form_token}/notification_rules",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": false,
+            "param": "body"
+        },
+        "successStatus": 201,
+        "scopes": [
+            "form_setting"
+        ],
+        "responseSchema": "NotificationRule"
+    },
+    "getNotificationRule": {
+        "operationId": "getNotificationRule",
+        "summary": "Get a notification rule",
+        "description": "Returns the rule and whether it can send right now.",
+        "tag": "Form Settings",
+        "method": "get",
+        "path": "/forms/{form_token}/notification_rules/{id}",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "form_setting"
+        ],
+        "responseSchema": "NotificationRule"
+    },
+    "updateNotificationRule": {
+        "operationId": "updateNotificationRule",
+        "summary": "Update a notification rule",
+        "description": "Changes the rule; the body takes only the keys of the rule's own `approach`, and `approach` itself cannot change.\n- Saving an enabled `schedule_time` rule schedules the entries already in the form whose send time is still ahead.",
+        "tag": "Form Settings",
+        "method": "patch",
+        "path": "/forms/{form_token}/notification_rules/{id}",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": false,
+            "param": "body"
+        },
+        "successStatus": 200,
+        "scopes": [
+            "form_setting"
+        ],
+        "responseSchema": "NotificationRule"
+    },
+    "deleteNotificationRule": {
+        "operationId": "deleteNotificationRule",
+        "summary": "Delete a notification rule",
+        "description": "Deletes the rule and cancels what it has scheduled but not yet sent.",
+        "tag": "Form Settings",
+        "method": "delete",
+        "path": "/forms/{form_token}/notification_rules/{id}",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "form_setting"
+        ]
+    },
+    "listNotificationRuleNotifications": {
+        "operationId": "listNotificationRuleNotifications",
+        "summary": "List a notification rule's sending records",
+        "description": "Lists the notifications a rule sent, newest first, with a summary of the matching records. Covers the last 180 days, as the form's notification log page does; notifications scheduled for later are not included.",
+        "tag": "Form Settings",
+        "method": "get",
+        "path": "/forms/{form_token}/notification_rules/{id}/notifications",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "start_date",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "end_date",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id",
+            "start_date",
+            "end_date",
+            "status",
+            "limit",
+            "next",
+            "skip"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "form_setting"
+        ],
+        "responseSchema": "NotificationListResponse"
+    },
     "updateFormTheme": {
         "operationId": "updateFormTheme",
         "summary": "Update a form's theme",
-        "description": "Partially updates the form's theme (colors, background, header image, typography, form container, submit button); PUT is accepted too.\n- The request body must contain at least one of primary_color / secondary_color / wallpaper / header / typography / form_container / submit_button (`generate_header_image` is turned into header.header_image_url, so it counts too); otherwise 400.\n- Header image source precedence: header_image_upload_token > header_image_base64 > header_image_url > header_image_attachment_id; when a header image is set and header.type is not given, header.type is set to image.\n- Background image source precedence: background_image_upload_token > background_image_url > background_image_attachment_id. Setting or removing the background image also removes the preset background image that comes with the theme template; the background color is kept.\n- `header_image_attachment_id` / `background_image_attachment_id` take the `attachment_id` returned by \"Upload a form image\" (image_type header / wallpaper); pass an empty string `\"\"` to remove the current image.\n- `header.carousel_images` replaces the carousel images as a whole: at most 5, not empty; each item gives one of image_upload_token / image_url / attachment_id, and an attachment_id must be a carousel image the form already has; when it is passed and header.type is not given, header.type is set to carousel.\n- Keys in `text_style` and `typography.*` use underscores (e.g. font_size); the server converts them to hyphenated CSS keys and merges them into the existing styles; the response uses the hyphenated keys.\n- `generate_header_image` has AI generate a header image and consumes AI points; returns 402 when points are insufficient, 400 when generation fails.\n- An image upload_token is the `form_image_token` used by \"Upload a form image\"; the image purpose it records must match (header / wallpaper / carousel), and its upload must be complete.",
+        "description": "Partially updates the form's theme: colors, background, header image, typography, form container and submit button.",
         "tag": "Form Settings",
         "method": "patch",
         "path": "/forms/{form_token}/theme",
@@ -1284,7 +1492,7 @@
     "updateExamSetting": {
         "operationId": "updateExamSetting",
         "summary": "Update a form's exam settings",
-        "description": "Partially updates an exam form's settings; PUT is accepted too. Only for exam-scene forms; otherwise returns 400.\n- When the plan does not support \"show the score after submission\", `notice_after_filling_mode` is forced to none and `success_message_rich_text` is ignored.\n- `interval_comments` replaces the existing range comments as a whole; it takes effect only when `notice_after_filling_mode` (passed in this request or already saved) is grade / explaination / answer; passing an empty array does not turn range comments off.\n- Range comments must have end_point ≥ start_point and must not overlap; otherwise 400.\n- Passing `show_timeout: true` returns 400 when the form already has required questions; once the time limit is on, question fields cannot be made required (required candidate info fields are not affected); to turn on the time limit, make the questions optional first.\n- When `notice_after_filling_mode` is not none, the server clears success_redirect_url / success_redirect_fields in the form's settings.\n- A request body with no recognized keys is a no-op and returns the current settings.",
+        "description": "Partially updates an exam form's settings.",
         "tag": "Form Settings",
         "method": "patch",
         "path": "/forms/{form_token}/exam_setting",
@@ -1335,7 +1543,7 @@
     "updateEvaluationSetting": {
         "operationId": "updateEvaluationSetting",
         "summary": "Update a form's evaluation settings",
-        "description": "Partially updates an evaluation form's settings; PUT is accepted too. Only for evaluation-scene forms; otherwise returns 400.\n- When the plan does not support \"show the evaluation report after submission\", `notice_after_filling_mode` is forced to none.\n- `evaluation_comments` replaces the total score range comments as a whole, and an empty array turns range comments off; it takes effect only when `notice_after_filling_mode` (passed in this request or already saved) is reports / customize.\n- A comment by score range must give both start_point and end_point; comments written with conditions in the form editor read back as `id` + `conditions` and must be passed back with their original id when updating (only comment / retry may change; the conditions cannot be changed and no range can be added); leaving one out or changing it returns 400.\n- `indicator_setting.indicators` replaces the dimensions as a whole; pass `api_code` back to keep an existing dimension's identity. A dimension can bind only scorable questions visible on the form, referenced by `field_api_codes` or `field_cids`; referencing an unknown field returns 400.\n- When `notice_after_filling_mode` is not none, the server clears success_redirect_url / success_redirect_fields in the form's settings.\n- A request body with no recognized keys is a no-op and returns the current settings.",
+        "description": "Partially updates an evaluation form's settings (schema `EvaluationSettingInput`).\n- `evaluation_comments` replaces the total score range comments as a whole (an empty array turns them off) and takes effect only when `notice_after_filling_mode`, passed or already saved, is reports / customize. A comment written with conditions in the form editor reads back as `id` + `conditions`; pass it back under that id, where only `comment` / `retry` can change.\n- `indicator_setting.indicators` replaces the dimensions as a whole; pass `api_code` back to keep a dimension. A dimension binds visible scorable questions by `field_api_codes` or `field_cids`.",
         "tag": "Form Settings",
         "method": "patch",
         "path": "/forms/{form_token}/evaluation_setting",
@@ -1698,7 +1906,7 @@
     "uploadEntryAttachment": {
         "operationId": "uploadEntryAttachment",
         "summary": "Upload an entry attachment",
-        "description": "Uploads a file ahead of time for a form's attachment field (or an attachment column in a table field) and returns the attachment ID; then, when creating / updating an entry, put that ID (or the upload token) into the matching field to bind it. An uploaded attachment that no entry references stays unused.\nAuthenticate in one of two ways:\n1. Regular API credentials (a Bearer token).\n2. A one-time upload token `attachment_token` (instead of regular credentials): the token starts with `entry_att_tok_`, is valid for 30 minutes, can be used only once, and is bound to the form, field, column and file metadata. When the request carries `attachment_token`, regular credentials are not checked and the request acts as the token's user; returns 400 `attachment_token is invalid or expired; prepare upload again` when the token is invalid, expired, already used, its user has been deleted, or it does not match the requested form / field / column; also returns 400 when the uploaded file's name, Content-Type or byte size does not match the token.\nReturns 401 when there are neither credentials nor `attachment_token`.\nSend the file content in one of two ways: the `file` field of `multipart/form-data`; or a Base64 string in the `base64` (or `data`) field of a JSON / form-encoded body (a `data:<mime>;base64,` prefix is allowed), with `file_name` (or `filename`) and `content_type`. Base64 content cannot exceed 5 MB once decoded; larger returns 400 `attachment exceeds 5MB limit`, and a decoding failure returns 400 `base64 is invalid`; returns 400 `file or base64 is required` when neither is given.\n`field_api_code` must point to an attachment field or a table field; for a table field, `dimension_api_code` must also be passed and point to an attachment column in that table field, otherwise returns 400; returns 404 when the field or column does not exist.\nThe file size is capped by the per-file limit set on the field (or column); a larger file returns 422, with the specific validation message in `error_description` (e.g. `文件超过了10 MB`); returns 422 `上传失败，请重试` when uploading to object storage fails (the server's wording is authoritative).\nReturns 404 `form cannot be found` when the form does not exist or is not accessible to the current identity.",
+        "description": "Uploads a file for an attachment field of the form, or for an attachment column of a table field.",
         "tag": "Uploads",
         "method": "post",
         "path": "/forms/{form_token}/entry_attachments",
@@ -1723,10 +1931,38 @@
         ],
         "responseSchema": "UploadedEntryAttachment"
     },
+    "prepareEntryAttachmentUpload": {
+        "operationId": "prepareEntryAttachmentUpload",
+        "summary": "Prepare an entry attachment upload",
+        "description": "Issues a one-time link for uploading a local file to an attachment field, or to an attachment column of a table field, without sending its bytes in a request body.\n- With a shell that can read the file and reach the network, run `curl -F file=@<path> <upload_url>`, then put the returned `attachment_id` in the field when creating or updating an entry.\n- Without one, or when curl fails (for example under a sandbox's network limits), send small content as Base64 to \"Upload an entry attachment\".",
+        "tag": "Uploads",
+        "method": "post",
+        "path": "/forms/{form_token}/entry_attachment_upload_urls",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "write_entries"
+        ],
+        "responseSchema": "PreparedUpload"
+    },
     "uploadImportFile": {
         "operationId": "uploadImportFile",
         "summary": "Upload an import file",
-        "description": "Uploads a spreadsheet file (`.xlsx` / `.xls` / `.csv`) for bulk-importing entries into the given form, and returns the import attachment ID; then pass it as `attachment_id` to \"Import entries from an uploaded spreadsheet\" (`POST /forms/{form_token}/entry_imports`) to start the import.\nAuthenticate in one of two ways:\n1. Regular API credentials (a Bearer token).\n2. A one-time upload token `import_file_token` (instead of regular credentials): the token starts with `import_file_tok_`, is valid for 30 minutes, can be used only once, and is bound to the form and the file metadata. When the request carries `import_file_token`, regular credentials are not checked, and the request acts as the user the token belongs to; the uploaded file's original file name, Content-Type and byte size must match what the token recorded, otherwise returns 400. Returns 400 `import_file_token is invalid or expired; prepare upload again` when the token does not exist, has expired, has been used, or its user has been deleted; returns 400 `import_file_token was issued for another form; prepare upload again` when the token belongs to another form.\nReturns 401 when there are neither credentials nor an `import_file_token`.\nThe request must be `multipart/form-data`, with the file in the `file` field; a missing file returns 400 `file is required`.\nThe file size is capped by the plan's Excel import limit (in MB), and the extension must be xls / xlsx / csv; otherwise returns 422, with the validation details in `error_description` (with an upload token, the token stays usable, so the file can be uploaded again).\nReturns 404 `form cannot be found` when the form does not exist or is not accessible to the current caller.",
+        "description": "Uploads a spreadsheet (`.xlsx` / `.xls` / `.csv`) for importing entries into the form.",
         "tag": "Uploads",
         "method": "post",
         "path": "/forms/{form_token}/import_files",
@@ -1751,10 +1987,33 @@
         ],
         "responseSchema": "UploadedImportFile"
     },
+    "prepareImportFileUpload": {
+        "operationId": "prepareImportFileUpload",
+        "summary": "Prepare an import file upload",
+        "description": "Issues a one-time link for uploading a local spreadsheet (`.xlsx` / `.xls` / `.csv`) to import into the form, without sending its bytes in a request body.\n- With a shell that can read the file and reach the network, run `curl -F file=@<path> <upload_url>`, then pass the returned `attachment_id` to \"Import entries from an uploaded spreadsheet\"; read the header row from your local copy.\n- Without one, or when curl fails, the file cannot be uploaded: spreadsheets have no Base64 route.",
+        "tag": "Uploads",
+        "method": "post",
+        "path": "/forms/{form_token}/import_file_upload_urls",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token"
+        ],
+        "successStatus": 201,
+        "scopes": [
+            "write_entries"
+        ],
+        "responseSchema": "PreparedUpload"
+    },
     "createEntryImport": {
         "operationId": "createEntryImport",
         "summary": "Import entries from an uploaded spreadsheet",
-        "description": "Appends each row of a spreadsheet uploaded with \"Upload an import file\" as an entry of this form. Upload the file first to get the import attachment ID (`attachment_id`), then say here which column goes into which field.\nProblems that can be detected up front, such as the file, the plan's import limit, the header row and the column mapping, are checked before the job is created; a rejected import writes no entries. Error messages include the spreadsheet's actual layout (row and column range, and the header contents), so the request can be fixed and retried.\nOnce validation passes, returns `201` and the entries are written in the background: `201` means the job has started, not finished; poll \"Show an entry import job\" for the result.\n- `attachment_id` must be an import file the current user uploaded for this form, otherwise returns 400 (the file cannot be found; upload it again); returns 400 when the file is not xls / xlsx / csv or cannot be read.\n- `columns` must not be empty; each item names the target field with `field_api_code`, and the source column with `column_label` (the header text, which must exactly match the header cell after trimming leading and trailing spaces) or `sheet_column_index` (the column number); when both are given, `sheet_column_index` wins.\n- The field must be one this form can import into; one field cannot map to several columns; when several header columns share a name, use `sheet_column_index` instead; the column number must be within the spreadsheet's column range.\n- `header_row_index` defaults to the first row of the spreadsheet, and there must be data rows below it.\n- Every required field of the form must have a column, otherwise returns 400 listing the missing fields.\n- `unique_field_code` names a field to deduplicate on: when a row's value for that field already exists in the form's entries, the row is skipped (counted in `skip_count`).\n- Returns 404 `form cannot be found` when the form does not exist or is not accessible to the current caller.",
+        "description": "Appends each row of a spreadsheet uploaded with \"Upload an import file\" as an entry of this form. Upload the file first to get the import attachment ID (`attachment_id`), then say here which column goes into which field.\nOnce validation passes, returns `201` and the entries are written in the background: `201` means the job has started, not finished; poll \"Show an entry import job\" for the result.\n- Every required field of the form needs a column, and a field takes at most one column.\n- A refused import writes no entries, and its error shows the row and column range and the header of the spreadsheet, so fix the mapping from it and retry.",
         "tag": "Entries",
         "method": "post",
         "path": "/forms/{form_token}/entry_imports",
@@ -1808,39 +2067,23 @@
         ],
         "responseSchema": "EntryImportJob"
     },
-    "uploadFormImage": {
-        "operationId": "uploadFormImage",
-        "summary": "Upload a form image",
-        "description": "Uploads an image that belongs to the form itself (a picture choice image, a header image, a background image, one frame of the header carousel, the header image of the form's public query page, or an inline image in the form description / a field description), and returns the image attachment ID. The image is not bound to any form yet; it takes effect only when a form or theme references it later.\nAuthenticate in one of two ways:\n1. Regular API credentials (a Bearer token). `image_type` must then say what the image is for, and can only be `header` (header image), `wallpaper` (background image), `opensearch_header` (public query page header image) or `description` (inline description image): pass the returned `attachment_id` to `header.header_image_attachment_id` / `wallpaper.background_image_attachment_id` of \"Update a form's theme\", or to `header.background_image.attachment_id` of \"Update a public query\"; `description` also returns the image address `url`, which goes into the `<img src>` of the form `description` or of a field's `notes`. When the form is saved, the image belongs to that form (at most 30 per form); images not used by any form within 7 days are cleaned up. Returns 400 `image_type must be one of: field_choice, header, wallpaper, carousel, opensearch_header, description.` when `image_type` is missing or not one of `field_choice` / `header` / `wallpaper` / `carousel` / `opensearch_header` / `description`; `field_choice` / `carousel` have nowhere that accepts an attachment ID, so they can only be uploaded with an upload token, otherwise returns 400.\n2. A one-time upload token `form_image_token` (instead of regular credentials): the token starts with `form_img_tok_`, is valid for 30 minutes, can be used only once, and has already recorded the image purpose (`field_choice` / `header` / `wallpaper` / `carousel` / `opensearch_header` / `description`; `image_type` is then ignored) and the file metadata; the uploaded file's original file name, Content-Type and byte size must match what the token recorded, otherwise returns 400. After a successful upload, do not use the returned `attachment_id` directly; instead reference the same token in a choice's `image_upload_token` in \"Create a form\" / \"Edit a form\", in `header.header_image_upload_token` / `wallpaper.background_image_upload_token` / `header.carousel_images[].image_upload_token` of \"Update a form's theme\", or in `header.background_image.image_upload_token` of \"Update a public query\"; for the `description` purpose nothing references the token, so use the returned `url` directly. Returns 400 `form_image_token is invalid or expired; prepare upload again` when the token does not exist, has expired, has been used, or its user has been deleted.\nReturns 401 when there are neither credentials nor a `form_image_token`. The request must be `multipart/form-data`, with the image binary in the `file` field; a missing file returns 400 `file is required`.",
-        "tag": "Uploads",
-        "method": "post",
-        "path": "/form_image_attachments",
-        "params": [],
-        "paramNames": [],
-        "body": {
-            "contentType": "multipart/form-data",
-            "required": true,
-            "flatten": true
-        },
-        "successStatus": 201,
-        "scopes": [
-            "forms",
-            "form_setting"
-        ],
-        "responseSchema": "UploadedFormImage"
-    },
-    "listTables": {
-        "operationId": "listTables",
-        "summary": "List tables",
-        "description": "Returns the tables (`kind=table`) visible to the current caller. Pagination, `q`, `filters`, `sort`, `next`, `skip` and `limit` mean the same as in the form list; 50 per page by default, up to 1000.",
-        "tag": "Tables",
+    "estimateSmsTask": {
+        "operationId": "estimateSmsTask",
+        "summary": "Estimate an SMS task",
+        "description": "Picks the entries an SMS task would send to and counts the messages it would charge, without sending anything.\n- `POST /forms/{form_token}/sms_tasks` with the same parameters picks the entries again when it runs, so its count changes if they changed in between.\n- A cooperator picks only the entries visible to their role.",
+        "tag": "Entries",
         "method": "get",
-        "path": "/tables",
+        "path": "/forms/{form_token}/sms_tasks/estimate",
         "params": [
             {
-                "name": "q",
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "entry_field",
                 "in": "query",
-                "required": false
+                "required": true
             },
             {
                 "name": "filters",
@@ -1849,23 +2092,844 @@
                 "json": true
             },
             {
-                "name": "sort",
+                "name": "keyword",
                 "in": "query",
-                "required": false,
-                "json": true
+                "required": false
             },
             {
-                "name": "next",
+                "name": "view_token",
                 "in": "query",
                 "required": false
             },
             {
-                "name": "skip",
+                "name": "select_all",
                 "in": "query",
                 "required": false
             },
             {
-                "name": "limit",
+                "name": "sms_template_id",
+                "in": "query",
+                "required": true
+            },
+            {
+                "name": "placeholder_keys",
+                "in": "query",
+                "required": false,
+                "array": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "entry_field",
+            "filters",
+            "keyword",
+            "view_token",
+            "select_all",
+            "sms_template_id",
+            "placeholder_keys"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "SMSTaskEstimate"
+    },
+    "listSmsTasks": {
+        "operationId": "listSmsTasks",
+        "summary": "List SMS tasks",
+        "description": "Lists the SMS tasks of this form.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/sms_tasks",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "start_date",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "end_date",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "status",
+            "start_date",
+            "end_date",
+            "limit",
+            "next",
+            "skip"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "EntryTaskListResponse"
+    },
+    "createSmsTask": {
+        "operationId": "createSmsTask",
+        "summary": "Send SMS to entries",
+        "description": "Creates an SMS task that sends a template message to each entry picked.\n- Estimate first with `GET /forms/{form_token}/sms_tasks/estimate` and send with the same parameters; the entries are picked again when this runs.\n- The task may wait in `template_checking` or `content_auditing` while the template or content is under review, and sends once approved.\n- When the estimate's `can_send` is false the task is still created, and when sending finds the quota and balance short it stops, ending `none_sent` or `partial_sent` with the reason in `failed_reason`.\n- Sent messages cannot be recalled, and retrying a request that succeeded sends again.",
+        "tag": "Entries",
+        "method": "post",
+        "path": "/forms/{form_token}/sms_tasks",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "write_entries"
+        ],
+        "responseSchema": "EntryTask"
+    },
+    "getSmsTask": {
+        "operationId": "getSmsTask",
+        "summary": "Show an SMS task",
+        "description": "Returns an SMS task of this form with its status and sending progress.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/sms_tasks/{id}",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "EntryTask"
+    },
+    "updateSmsTask": {
+        "operationId": "updateSmsTask",
+        "summary": "Revoke an SMS task, or change one whose template failed review and send it again",
+        "description": "Revokes an SMS task that has not started sending, or changes a `template_fail` task and sends it again, keeping its `id`.\n- `revoked: true` revokes a `waiting_for_send` or `content_auditing` task so it never sends.\n- Otherwise the body changes a `template_fail` task, keeping its entries. Estimate first with `GET /forms/{form_token}/sms_tasks/{id}/estimate`.\n- A changed task goes through review and sending as one created by `POST /forms/{form_token}/sms_tasks`; sent messages cannot be recalled.",
+        "tag": "Entries",
+        "method": "patch",
+        "path": "/forms/{form_token}/sms_tasks/{id}",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 200,
+        "scopes": [
+            "write_entries"
+        ],
+        "responseSchema": "EntryTask"
+    },
+    "listSmsTaskActivities": {
+        "operationId": "listSmsTaskActivities",
+        "summary": "List an SMS task's sending results",
+        "description": "Lists the sending result of each mobile number an SMS task sent to.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/sms_tasks/{id}/activities",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "mobile",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id",
+            "status",
+            "mobile",
+            "limit",
+            "next",
+            "skip"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "SMSTaskActivityListResponse"
+    },
+    "estimateSmsTaskResend": {
+        "operationId": "estimateSmsTaskResend",
+        "summary": "Estimate resending an SMS task",
+        "description": "Picks the entries that resending an SMS task would send to and counts the messages it would charge, without sending anything.\n- The entries are the task's entries with the `status` result in its sending results, narrowed by `filters` / `keyword` / `view_token`; no other entry is ever picked.\n- An entry holding several numbers is picked when any of them got that result, and is sent to on all of them.\n- `POST /forms/{form_token}/sms_tasks/{id}/resend` with the same parameters picks the entries again when it runs, so its count changes if they changed in between.\n- A cooperator picks only the entries visible to their role.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/sms_tasks/{id}/resend/estimate",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": true
+            },
+            {
+                "name": "filters",
+                "in": "query",
+                "required": false,
+                "json": true
+            },
+            {
+                "name": "keyword",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "view_token",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id",
+            "status",
+            "filters",
+            "keyword",
+            "view_token"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "SMSTaskEstimate"
+    },
+    "resendSmsTask": {
+        "operationId": "resendSmsTask",
+        "summary": "Resend an SMS task",
+        "description": "Sends an SMS task again as a new task, to its entries with a given result in its sending results.\n- Estimate first with `GET /forms/{form_token}/sms_tasks/{id}/resend/estimate` and send with the same parameters; the entries are picked again when this runs.\n- The new task keeps the original's template, `entry_field` and `placeholder_keys` and is sent as by `POST /forms/{form_token}/sms_tasks`; the original task is left unchanged.\n- Sent messages cannot be recalled, and retrying a request that succeeded sends again.",
+        "tag": "Entries",
+        "method": "post",
+        "path": "/forms/{form_token}/sms_tasks/{id}/resend",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "write_entries"
+        ],
+        "responseSchema": "EntryTask"
+    },
+    "estimateSmsTaskChange": {
+        "operationId": "estimateSmsTaskChange",
+        "summary": "Estimate changing an SMS task whose template failed review",
+        "description": "Estimates changing a `template_fail` SMS task and sending it again, without changing or sending anything.\n- Counts the entries the task holds without reading them: content with variables gives a lower bound (`at_least`), and a table column `entry_field` gives null numbers and cost.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/sms_tasks/{id}/estimate",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "entry_field",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "sms_template_id",
+                "in": "query",
+                "required": true
+            },
+            {
+                "name": "placeholder_keys",
+                "in": "query",
+                "required": false,
+                "array": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id",
+            "entry_field",
+            "sms_template_id",
+            "placeholder_keys"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "SMSTaskEstimate"
+    },
+    "sendSmsTask": {
+        "operationId": "sendSmsTask",
+        "summary": "Send an SMS task created with auto_send false",
+        "description": "Sends a task created with `auto_send` false once it has passed review, to the entries fixed at creation; a task given `send_at` waits until then.",
+        "tag": "Entries",
+        "method": "patch",
+        "path": "/forms/{form_token}/sms_tasks/{id}/auto_send",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "write_entries"
+        ],
+        "responseSchema": "EntryTask"
+    },
+    "estimateEmailTask": {
+        "operationId": "estimateEmailTask",
+        "summary": "Estimate an email task",
+        "description": "Picks the entries an email task would send to and checks the quota, without sending anything.\n- `POST /forms/{form_token}/email_tasks` with the same parameters picks the entries again when it runs, so its count changes if they changed in between.\n- A cooperator picks only the entries visible to their role.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/email_tasks/estimate",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "entry_field",
+                "in": "query",
+                "required": true
+            },
+            {
+                "name": "filters",
+                "in": "query",
+                "required": false,
+                "json": true
+            },
+            {
+                "name": "keyword",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "view_token",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "select_all",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "smtp_account_id",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "entry_field",
+            "filters",
+            "keyword",
+            "view_token",
+            "select_all",
+            "smtp_account_id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "EmailTaskEstimate"
+    },
+    "listEmailTasks": {
+        "operationId": "listEmailTasks",
+        "summary": "List email tasks",
+        "description": "Lists the email tasks of this form.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/email_tasks",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "start_date",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "end_date",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "status",
+            "start_date",
+            "end_date",
+            "limit",
+            "next",
+            "skip"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "EntryTaskListResponse"
+    },
+    "createEmailTask": {
+        "operationId": "createEmailTask",
+        "summary": "Send email to entries",
+        "description": "Creates an email task that sends an email to each entry picked, starting right away.\n- Estimate first with `GET /forms/{form_token}/email_tasks/estimate` and send with the same parameters; the entries are picked again when this runs.\n- When the estimate's `can_send` is false the task is still created, and when sending finds the quota and balance short it stops, ending `none_sent` or `partial_sent` with the reason in `failed_reason`.\n- Sent emails cannot be recalled, and retrying a request that succeeded sends again.",
+        "tag": "Entries",
+        "method": "post",
+        "path": "/forms/{form_token}/email_tasks",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "write_entries"
+        ],
+        "responseSchema": "EntryTask"
+    },
+    "getEmailTask": {
+        "operationId": "getEmailTask",
+        "summary": "Show an email task",
+        "description": "Returns an email task of this form with its status and sending progress.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/email_tasks/{id}",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "EntryTask"
+    },
+    "listEmailTaskActivities": {
+        "operationId": "listEmailTaskActivities",
+        "summary": "List an email task's sending results",
+        "description": "Lists the sending result of each entry an email task sent to.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/email_tasks/{id}/activities",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "email",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id",
+            "status",
+            "email",
+            "limit",
+            "next",
+            "skip"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "EmailTaskActivityListResponse"
+    },
+    "estimateEmailTaskResend": {
+        "operationId": "estimateEmailTaskResend",
+        "summary": "Estimate resending an email task",
+        "description": "Picks the entries that resending an email task would send to and checks the quota, without sending anything.\n- The entries are the task's entries with the `status` result in its sending results, narrowed by `filters` / `keyword` / `view_token`; no other entry is ever picked.\n- The emails go through the task's custom SMTP account, using no quota, while the account can still use it.\n- `POST /forms/{form_token}/email_tasks/{id}/resend` with the same parameters picks the entries again when it runs, so its count changes if they changed in between.\n- A cooperator picks only the entries visible to their role.",
+        "tag": "Entries",
+        "method": "get",
+        "path": "/forms/{form_token}/email_tasks/{id}/resend/estimate",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": true
+            },
+            {
+                "name": "filters",
+                "in": "query",
+                "required": false,
+                "json": true
+            },
+            {
+                "name": "keyword",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "view_token",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id",
+            "status",
+            "filters",
+            "keyword",
+            "view_token"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "read_entries"
+        ],
+        "responseSchema": "EmailTaskEstimate"
+    },
+    "resendEmailTask": {
+        "operationId": "resendEmailTask",
+        "summary": "Resend an email task",
+        "description": "Sends an email task again as a new task, to its entries with a given result in its sending results.\n- Estimate first with `GET /forms/{form_token}/email_tasks/{id}/resend/estimate` and send with the same parameters; the entries are picked again when this runs.\n- The new task keeps the original's `entry_field`, subject, body and custom SMTP account and is sent as by `POST /forms/{form_token}/email_tasks`; the original task is left unchanged.\n- Sent emails cannot be recalled, and retrying a request that succeeded sends again.",
+        "tag": "Entries",
+        "method": "post",
+        "path": "/forms/{form_token}/email_tasks/{id}/resend",
+        "params": [
+            {
+                "name": "form_token",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "form_token",
+            "id"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "write_entries"
+        ],
+        "responseSchema": "EntryTask"
+    },
+    "uploadFormImage": {
+        "operationId": "uploadFormImage",
+        "summary": "Upload a form image",
+        "description": "Uploads an image for a form; it takes effect once a form, theme or public query references it.\n- `description` returns a `url` for an `<img src>` in the form `description` or a field's `notes`, at most 30 per form; every other type returns an `attachment_id` for the property that names that `image_type`.\n- An `attachment_id` is taken only where its `image_type` goes, and only while the image is unused or already that form's; an image nothing uses within 7 days is deleted.",
+        "tag": "Uploads",
+        "method": "post",
+        "path": "/form_image_attachments",
+        "params": [],
+        "paramNames": [],
+        "body": {
+            "contentType": "multipart/form-data",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "forms",
+            "form_setting"
+        ],
+        "responseSchema": "UploadedFormImage"
+    },
+    "prepareFormImageUpload": {
+        "operationId": "prepareFormImageUpload",
+        "summary": "Prepare a form image upload",
+        "description": "Issues a one-time link for uploading a local image for a form, without sending its bytes in a request body.\n- With a shell that can read the file and reach the network, run `curl -F file=@<path> <upload_url>`, then use the returned `attachment_id` (or `url`) where its `image_type` goes.\n- Without one, or when curl fails (for example under a sandbox's network limits), give a public image URL or a small Base64 image where the image goes.",
+        "tag": "Uploads",
+        "method": "post",
+        "path": "/form_image_upload_urls",
+        "params": [],
+        "paramNames": [],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "forms",
+            "form_setting"
+        ],
+        "responseSchema": "PreparedUpload"
+    },
+    "uploadUserLicenseAttachment": {
+        "operationId": "uploadUserLicenseAttachment",
+        "summary": "Upload a license image",
+        "description": "Uploads a business license or ID card image for `POST /sms/signatures` and `PATCH /sms/signatures/{id}`; only the uploader can use it.",
+        "tag": "Uploads",
+        "method": "post",
+        "path": "/user/license_attachments",
+        "params": [],
+        "paramNames": [],
+        "body": {
+            "contentType": "multipart/form-data",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "UploadedLicenseAttachment"
+    },
+    "listTables": {
+        "operationId": "listTables",
+        "summary": "List tables",
+        "description": "Returns the tables (`kind=table`) visible to the current caller. Pagination, `q`, `filters`, `sort`, `next`, `skip` and `limit` mean the same as in the form list; 50 per page by default, up to 1000.",
+        "tag": "Tables",
+        "method": "get",
+        "path": "/tables",
+        "params": [
+            {
+                "name": "q",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "filters",
+                "in": "query",
+                "required": false,
+                "json": true
+            },
+            {
+                "name": "sort",
+                "in": "query",
+                "required": false,
+                "json": true
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
                 "in": "query",
                 "required": false
             }
@@ -1887,7 +2951,7 @@
     "createTable": {
         "operationId": "createTable",
         "summary": "Create a table",
-        "description": "Creates a table. Same as creating a form, except:\n- field types can only be the column types tables support: `TextArea`, `RadioButton`, `CheckBox`, `BooleanField`, `MobileField`, `NumberField`, `DateTimeField`, `EmailField`, `LinkField`, `AttachmentField`, `FormulaField`, `RelationField`;\n- attachment columns do not accept limit properties such as count / size limits, and number / formula columns have limited precision; a violation returns 400 listing the offending columns;\n- choice columns do not get an \"Other\" choice; `folder_token` must be a table folder; `layout` is not supported.\n- with `with_default_entries: true`, 3 blank entries are added after creation (as when creating a table in the product); by default none are added.\nReturns the table structure, including fields and views.",
+        "description": "Creates a table. Same as creating a form, except:\n- field types can only be the column types tables support: `TextArea`, `RadioButton`, `CheckBox`, `BooleanField`, `MobileField`, `NumberField`, `DateTimeField`, `EmailField`, `LinkField`, `AttachmentField`, `FormulaField`, `RelationField`, `SequenceField`;\n- attachment columns do not accept limit properties such as count / size limits, and number / formula columns have limited precision; a violation returns 400 listing the offending columns;\n- choice columns do not get an \"Other\" choice; `folder_token` must be a table folder; `layout` is not supported.\n- with `with_default_entries: true`, 3 blank entries are added after creation (as when creating a table in the product); by default none are added.\nReturns the table structure, including fields and views.",
         "tag": "Tables",
         "method": "post",
         "path": "/tables",
@@ -2978,7 +4042,7 @@
     "createCheckinCampaign": {
         "operationId": "createCheckinCampaign",
         "summary": "Create a check-in campaign",
-        "description": "Turns check-in on for a form. The caller must be able to reach the form.\n- Same limits as picking a form in the web app: returns 400 when the form has WeChat red envelope, lucky wheel, certificate or confirmation code on, already has a check-in campaign with a check-in code in effect, is bound to another plugin that takes over the after-submit redirect, or its after-submit action is not the default message. Turn that off first.\n- Only one check-in campaign is in effect on a form at a time; creating one turns off the one that was in effect.\n- Without `checkin_field_api_code`, the form's first mobile field is used, then its first name field; with neither, returns 400. The check-in field cannot be changed afterwards.\n- The campaign belongs to the caller, or to the account owner with an account-level credential. The caller is also added as a verifier.\n- `enable_checkin_code` (on by default) rewrites the form's after-submit redirect and data push URL to the check-in code page, and overrides any Webhook already on the form (and the other way round).",
+        "description": "Turns check-in on for a form.\n- Refused while the after-submit step of the form is taken by something else (WeChat red envelope, lucky wheel, certificate, confirmation code, another plugin or the check-in code of another campaign, or an after-submit action other than the default message); the message names it, so turn that off first.\n- Only one check-in campaign is in effect on a form at a time; creating one turns off the one that was in effect.",
         "tag": "Plugins",
         "method": "post",
         "path": "/plugins/checkin/campaigns",
@@ -3227,6 +4291,29 @@
         ],
         "responseSchema": "Folder"
     },
+    "getFolder": {
+        "operationId": "getFolder",
+        "summary": "Show a folder",
+        "description": "Returns one folder the current user can manage.",
+        "tag": "Folders",
+        "method": "get",
+        "path": "/folders/{folder_token}",
+        "params": [
+            {
+                "name": "folder_token",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "folder_token"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "forms"
+        ],
+        "responseSchema": "Folder"
+    },
     "listPredefinedChoicesSets": {
         "operationId": "listPredefinedChoicesSets",
         "summary": "List predefined choice sets",
@@ -3370,7 +4457,7 @@
     "getBillingAccount": {
         "operationId": "getBillingAccount",
         "summary": "Show the current account",
-        "description": "Returns the account the current credential belongs to: plan, this month's usage and quota, feature trial status, and the bound payment merchant / WeChat Pay / Alipay accounts.\n`usage` is null when the account has no usage record for this month yet; for an add-on service with unlimited quota, only `unit`, `unlimited: true` and `consumed_quota` are returned.",
+        "description": "Returns the account the current credential belongs to: plan, this month's usage and quota, feature trial status, and the bound payment merchant / WeChat Pay / Alipay accounts.\n`usage` is null when the account has no usage record for this month yet.",
         "tag": "Account",
         "method": "get",
         "path": "/billing_account",
@@ -3466,10 +4553,25 @@
         ],
         "responseSchema": "BillingAccountPaymentHistoriesResponse"
     },
+    "listBillingAccountPaidFeatures": {
+        "operationId": "listBillingAccountPaidFeatures",
+        "summary": "List the paid features and whether the account has each",
+        "description": "Lists every paid feature with its Chinese name and whether the account has it now; one bought or granted on its own counts. Quotas, and whether each add-on service can still be used, are in `usage` of `GET /billing_account`.",
+        "tag": "Account",
+        "method": "get",
+        "path": "/billing_account/paid_features",
+        "params": [],
+        "paramNames": [],
+        "successStatus": 200,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "BillingAccountPaidFeaturesResponse"
+    },
     "getTradeMerchant": {
         "operationId": "getTradeMerchant",
         "summary": "Show the 小金商户",
-        "description": "Returns the current account's 小金商户 (the merchant Jinshuju collects payments for) and its onboarding progress: merchant profile, legal entity and contact details, balance, settlement details, payment channel authorization, freeze status, bound payment forms, and the URL for the next step.\n- When the account has no 小金商户 yet, it still returns 200: `merchant_stage` says how far the onboarding application has got, `merchant` / `subject` / `contact` / `balance` / `settlement` / `freeze` are null, and `channels` is an empty array.\n- An account that collects payments through its own WeChat Pay / Alipay merchant (direct connection) has no rate, settlement account, balance or onboarding status on Jinshuju, and none of these is given here.\n- Sensitive fields such as bank card numbers, mobile numbers, emails and ID numbers are masked by the rules of the product's \"Fund account information\" page: 4 characters are kept at each end (mobile numbers keep the first 3 and last 4), and the middle is replaced with `*`.\n- `payment_form_tokens` holds only the payment forms the current identity can access (quick payment forms included); with an account-level credential, it is computed for the account owner.\n- `balance` is null when the balance lookup fails; that does not mean the balance is 0.",
+        "description": "Returns the current account's 小金商户 (the merchant Jinshuju collects payments for) and its onboarding progress: merchant profile, legal entity and contact details, balance, settlement details, payment channel authorization, freeze status, bound payment forms, and the URL for the next step.\n- An account without a 小金商户 still gets 200, with `merchant_stage` saying how far onboarding has got; an account that collects payments through its own WeChat Pay / Alipay merchant (direct connection) has no rate, settlement account, balance or onboarding status on Jinshuju.\n- `balance` is null when the balance lookup failed, which does not mean the balance is 0.",
         "tag": "Trade",
         "method": "get",
         "path": "/trade/merchant",
@@ -3484,7 +4586,7 @@
     "listTradeTransactions": {
         "operationId": "listTradeTransactions",
         "summary": "List payment orders",
-        "description": "Lists the payment orders of the 小金商户 (orders customers place by paying on payment forms), newest order first. Only 小金商户 orders are included: orders collected through a direct connection, simulated-payment orders, and unpaid quick payment records are all left out.\n- The date range filters on order time, in Beijing time (UTC+8); `start_date` / `end_date` are both inclusive and must be passed together. Without them, it defaults to the last 90 days; with `order_no` and no dates, there is no time limit. `queried_range` in the response gives the range actually used (both ends null when there is no time limit).\n- Detail limits: the date range spans at most 90 days, and at most 200 orders match. Past either limit, no details are returned: `transactions` is null, `detail_limit` says why, and `stats` gives the transaction amount, paid count and order count for the range; narrow the range and query again.\n- Paging: `limit` is the page size (default and maximum 50), and `next` is a page number. When there is another page, the response carries `next` (the next page number); pass it back as is. `page_info.total` is the total number of matching orders.\n- Returns 404 when the account has no 小金商户.",
+        "description": "Lists the payment orders of the 小金商户 (orders customers place by paying on payment forms), filtered and sorted newest first by order time. Only 小金商户 orders are included: orders collected through a direct connection, simulated-payment orders, and unpaid quick payment records are all left out.\n- Without dates, covers the last 90 days.\n- Records are returned only for a range of at most 90 days with at most 200 matching orders: past either, `transactions` is null, `detail_limit` says why, and `stats` still covers the range; narrow the range to get the records.",
         "tag": "Trade",
         "method": "get",
         "path": "/trade/transactions",
@@ -3604,7 +4706,7 @@
     "listTradeRefunds": {
         "operationId": "listTradeRefunds",
         "summary": "List refunds",
-        "description": "Lists the refunds the 小金商户 issued to customers, with statistics. Refunds are filtered and sorted newest first by the time they were issued, not by the order time or the time the refund arrived. Only a 小金商户 has refund records; an account collecting payments through a direct connection has no data here.\n- The date range is in Beijing time (UTC+8); both ends are inclusive and must be passed together. Without them, it defaults to the last 90 days; with `refund_no` and no dates, there is no time limit. `queried_range` gives the range actually used.\n- `include` decides what is returned: `both` (default) returns `stats` and `refunds` together, `stats` returns the statistics alone, `records` returns the records alone.\n- The detail limits are those of \"List payment orders\" (at most 90 days, 200 records): past them, `refunds` is null, `detail_limit` says why, and `stats` is returned as usual.\n- `stats`: the count and amount of all matching refunds, the count and amount per status, the number of distinct orders with a successful refund, and the trend by refund issue date (only when there is a date range; by day under 90 days, by week from 90 days, by month from 365 days, periods without refunds filled with zero). In the trend, order counts are deduplicated within each period, so the sum over periods can exceed the total order count.\n- Paging works as in \"List payment orders\"; with `include=stats`, `next` is not returned.\n- Returns 404 when the account has no 小金商户.",
+        "description": "Lists the refunds the 小金商户 issued to customers, with statistics. Refunds are filtered and sorted newest first by the time they were issued, not by the order time or the time the refund arrived.\n- Without dates, covers the last 90 days.\n- Records are returned only for a range of at most 90 days with at most 200 matching refunds: past either, `refunds` is null, `detail_limit` says why, and `stats` still covers the range.",
         "tag": "Trade",
         "method": "get",
         "path": "/trade/refunds",
@@ -3657,34 +4759,213 @@
         "successStatus": 200,
         "scopes": [
             "users"
-        ],
-        "responseSchema": "TradeRefundListResponse"
+        ],
+        "responseSchema": "TradeRefundListResponse"
+    },
+    "listTradePayouts": {
+        "operationId": "listTradePayouts",
+        "summary": "List payouts",
+        "description": "Lists the payouts the 小金商户 made from its Jinshuju balance to its own bank account, with statistics. Payouts are filtered and sorted newest first by request time.\n- Without dates, covers the last 90 days.\n- Records are returned only for a range of at most 90 days with at most 200 matching payouts: past either, `payouts` is null, `detail_limit` says why, and `stats` still covers the range.",
+        "tag": "Trade",
+        "method": "get",
+        "path": "/trade/payouts",
+        "params": [
+            {
+                "name": "start_date",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "end_date",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "include",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "start_date",
+            "end_date",
+            "status",
+            "include",
+            "limit",
+            "next"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "TradePayoutListResponse"
+    },
+    "listSmsAuditStatuses": {
+        "operationId": "listSmsAuditStatuses",
+        "summary": "Show SMS signature review status",
+        "description": "Lists the SMS signatures the current user applied for and the SMS templates under each signature, with review status and the reason a review failed, newest signature first.\nReturns only the current user's own signatures, not those of other members of the account; with an account-level credential, returns the account owner's signatures. Any member can call it; admin is not required.",
+        "tag": "Account",
+        "method": "get",
+        "path": "/sms/audit_statuses",
+        "params": [],
+        "paramNames": [],
+        "successStatus": 200,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "SMSAuditStatusResponse"
+    },
+    "listSmsSignatures": {
+        "operationId": "listSmsSignatures",
+        "summary": "List SMS signatures",
+        "description": "Lists the account's SMS signatures, newest first. Pagination as in the form list; 50 per page by default, up to 1000.",
+        "tag": "Account",
+        "method": "get",
+        "path": "/sms/signatures",
+        "params": [
+            {
+                "name": "status",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "status",
+            "limit",
+            "next",
+            "skip"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "SMSSignatureListResponse"
+    },
+    "createSmsSignature": {
+        "operationId": "createSmsSignature",
+        "summary": "Apply for an SMS signature",
+        "description": "Applies for an SMS signature and submits it for review; follow the result with `GET /sms/signatures`.\n- Upload the images with `POST /user/license_attachments` first.\n- A signature the account already has under review or approved is returned unchanged.\n- The materials replace the user's ID card information, and the account's business license unless the account has passed license verification.",
+        "tag": "Account",
+        "method": "post",
+        "path": "/sms/signatures",
+        "params": [],
+        "paramNames": [],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "SMSSignature"
+    },
+    "updateSmsSignature": {
+        "operationId": "updateSmsSignature",
+        "summary": "Update an SMS signature",
+        "description": "Changes a rejected signature of the account and submits it for review again.\n- After a text change, its templates stay under the old text until each is updated with `PATCH /sms/templates/{id}`.\n- The materials replace the user's ID card information, and the account's business license unless the account has passed license verification.",
+        "tag": "Account",
+        "method": "patch",
+        "path": "/sms/signatures/{id}",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "id"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 200,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "SMSSignature"
+    },
+    "deleteSmsSignature": {
+        "operationId": "deleteSmsSignature",
+        "summary": "Delete an SMS signature",
+        "description": "Deletes a rejected signature of the account together with all its templates, including other members' ones.",
+        "tag": "Account",
+        "method": "delete",
+        "path": "/sms/signatures/{id}",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "users"
+        ]
     },
-    "listTradePayouts": {
-        "operationId": "listTradePayouts",
-        "summary": "List payouts",
-        "description": "Lists the payouts the 小金商户 made from its Jinshuju balance to its own bank account, with statistics. Payouts are filtered and sorted newest first by request time; each record carries the settlement date range the payout covers, but it cannot be filtered on. Only a 小金商户 has payout records; an account collecting payments through a direct connection has no data here.\n- The date range is in Beijing time (UTC+8); both ends are inclusive and must be passed together. Without them, it defaults to the last 90 days. `queried_range` gives the range actually used.\n- `include` decides what is returned: `both` (default) returns `stats` and `payouts` together, `stats` returns the statistics alone, `records` returns the records alone.\n- The detail limits are those of \"List payment orders\" (at most 90 days, 200 records): past them, `payouts` is null, `detail_limit` says why, and `stats` is returned as usual.\n- `stats`: the count and amount of all matching payouts, and the count and amount per status.\n- Paging works as in \"List payment orders\"; with `include=stats`, `next` is not returned.\n- For the balance awaiting payout and the settlement cycle, see \"Show the 小金商户\". Returns 404 when the account has no 小金商户.",
-        "tag": "Trade",
+    "listSmsTemplates": {
+        "operationId": "listSmsTemplates",
+        "summary": "List SMS templates",
+        "description": "Lists the templates the current user created and the ones other members share, newest first. Pagination as in the form list; 50 per page by default, up to 1000.",
+        "tag": "Account",
         "method": "get",
-        "path": "/trade/payouts",
+        "path": "/sms/templates",
         "params": [
             {
-                "name": "start_date",
+                "name": "q",
                 "in": "query",
                 "required": false
             },
             {
-                "name": "end_date",
+                "name": "scope",
                 "in": "query",
                 "required": false
             },
             {
-                "name": "status",
+                "name": "signature_id",
                 "in": "query",
                 "required": false
             },
             {
-                "name": "include",
+                "name": "status",
                 "in": "query",
                 "required": false
             },
@@ -3697,36 +4978,112 @@
                 "name": "next",
                 "in": "query",
                 "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
             }
         ],
         "paramNames": [
-            "start_date",
-            "end_date",
+            "q",
+            "scope",
+            "signature_id",
             "status",
-            "include",
             "limit",
-            "next"
+            "next",
+            "skip"
         ],
         "successStatus": 200,
         "scopes": [
             "users"
         ],
-        "responseSchema": "TradePayoutListResponse"
+        "responseSchema": "SMSTemplateListResponse"
     },
-    "listSmsAuditStatuses": {
-        "operationId": "listSmsAuditStatuses",
-        "summary": "Show SMS signature review status",
-        "description": "Lists the SMS signatures the current user applied for and the SMS templates under each signature, with review status and the reason a review failed, newest signature first.\nReturns only the current user's own signatures, not those of other members of the account; with an account-level credential, returns the account owner's signatures. Any member can call it; admin is not required.",
+    "createSmsTemplate": {
+        "operationId": "createSmsTemplate",
+        "summary": "Submit an SMS template for review",
+        "description": "Submits an SMS template for review under a notification signature the account has applied for, even one still under review; follow the result with `GET /sms/templates`.",
+        "tag": "Account",
+        "method": "post",
+        "path": "/sms/templates",
+        "params": [],
+        "paramNames": [],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "SMSTemplate"
+    },
+    "updateSmsTemplate": {
+        "operationId": "updateSmsTemplate",
+        "summary": "Update an SMS template",
+        "description": "Changes a template the current user created and submits it for review again; an approved one cannot be sent until approved again.",
+        "tag": "Account",
+        "method": "patch",
+        "path": "/sms/templates/{id}",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "id"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 200,
+        "scopes": [
+            "users"
+        ],
+        "responseSchema": "SMSTemplate"
+    },
+    "deleteSmsTemplate": {
+        "operationId": "deleteSmsTemplate",
+        "summary": "Delete an SMS template",
+        "description": "Deletes a template the current user created; notifications that send it stop sending SMS.",
+        "tag": "Account",
+        "method": "delete",
+        "path": "/sms/templates/{id}",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "users"
+        ]
+    },
+    "listSmtpAccounts": {
+        "operationId": "listSmtpAccounts",
+        "summary": "List SMTP accounts",
+        "description": "Lists the verified custom SMTP accounts the account can send email through.\n- The list is empty when the plan does not include custom SMTP.\n- Every member gets the same list; admin is not required.",
         "tag": "Account",
         "method": "get",
-        "path": "/sms/audit_statuses",
+        "path": "/smtp_accounts",
         "params": [],
         "paramNames": [],
         "successStatus": 200,
         "scopes": [
             "users"
         ],
-        "responseSchema": "SMSAuditStatusResponse"
+        "responseSchema": "SMTPAccountListResponse"
     },
     "verifyRedirectParams": {
         "operationId": "verifyRedirectParams",
@@ -3959,7 +5316,7 @@
     "listMySubmittedEntries": {
         "operationId": "listMySubmittedEntries",
         "summary": "List my entries in a form",
-        "description": "Returns the entries the current user submitted to the given form, newest first. The form need not be created by or shared with the current user: only the user's own entries are returned,\nwith only the fields the form makes public to submitters (hidden fields are neither returned nor usable for filtering or searching). Returns an empty list when the user has not submitted.\n- `fields` keeps only the given public fields; unknown or non-public api_codes are skipped (no error).\n- `filters` works as in the entry list, but cannot filter by `creator_id` (results are already limited to the user's own) or on non-public fields; doing so returns 400.\n- `keyword` searches only the user's own entries and is not subject to the form's entry-count limit.\n- Pagination: `next` is a row offset; `skip` and `next` cannot be combined. 50 rows per page by default, adjustable with `limit` (at most 1000).\n- An account access token has no \"current user\"; calling with one returns 400. Returns 404 when the form does not exist.",
+        "description": "Returns the entries the current user submitted to the given form, newest first. The form need not be created by or shared with the current user: only the user's own entries are returned,\nwith only the fields the form makes public to submitters (hidden fields are neither returned nor usable for filtering or searching).\n- `filters` works as in the entry list, but cannot use `creator_id`, since results are already the user's own.\n- `keyword` is not subject to the form's entry-count limit.\n- An account access token has no \"current user\"; calling with one returns 400.",
         "tag": "Entries",
         "method": "get",
         "path": "/my/forms/{form_token}/entries",
@@ -4026,7 +5383,7 @@
     "searchMySubmittedEntries": {
         "operationId": "searchMySubmittedEntries",
         "summary": "Search my entries",
-        "description": "Searches the current user's own entries across forms with one keyword (only fields the form makes public to submitters are searched), and returns the match count and serial numbers for each matching form.\n- `keyword` is required; returns 400 when empty.\n- By default, searches every form the current user has submitted to (quick payment forms excluded); `form_tokens` limits it to some of them, and tokens not in the user's submission history are ignored.\n  Returns 400 when more than 20 forms are in the search; narrow them with `form_tokens`.\n- Forms with no match are left out of the result; when a form cannot be searched (e.g. the keyword is too long), that form returns `unavailable` with an explanation and the other forms return as usual.\n- At most 50 serial numbers are returned per form; `matched` is the form's actual total match count.\n- An account access token has no \"current user\"; calling with one returns 400.",
+        "description": "Searches the current user's own entries in every form they submitted to (quick payment forms excluded) with one keyword, over the fields each form makes public to submitters, and returns the match count and serial numbers for each matching form.\n- One call searches at most 20 forms; past that, name the ones to search in `form_tokens`.\n- An account access token has no \"current user\"; calling with one returns 400.",
         "tag": "Entries",
         "method": "get",
         "path": "/my/search",
@@ -4056,7 +5413,7 @@
     "getFillFormPage": {
         "operationId": "getFillFormPage",
         "summary": "Show a form's fill page",
-        "description": "Reads the fill page behind a fill link (`/f/<token>`): its title, description, the fields to fill in, and whether the current user can submit right now.\nThe caller reads it as a submitter holding the link and needs no permission on the form or table; only what the fill page shows is returned.\n- `fields` lists the public fields in fill-page order, shaped like `fields` when reading a form; for a form view, column names, descriptions and required flags already follow the view's settings.\n- Submission is possible only when `status.key` is `open`; other values (such as `not_opened`, `closed`, `password_required`, `unauthorized`, `submission_prevented`,\n  `fill_frequency_limited`: the current user has used up the submissions the fill page allows) are explained in `status.message`; when the page is not yet open or has closed on schedule, `status.open_info` gives the open period.\n- `blockers` lists requirements only the submitter can complete on the page (captcha, SMS verification, WeChat identity, payment, etc.); when it is not empty, submission is refused and the form must be filled in a browser.\n- `manageable` is returned only when the current user can already read the underlying form or table, and gives its token and name.\n- An account access token has no \"current user\"; calling with one returns 400.",
+        "description": "Reads the fill page behind a fill link (`/f/<token>`): its title, description, the fields to fill in, and whether the current user can submit right now.\nThe caller reads it as a submitter holding the link and needs no permission on the form or table; only what the fill page shows is returned.\n- Submit through the API only when `status.key` is `open` and `blockers` is empty; otherwise `status.message` says why, and a non-empty `blockers` means the page must be filled in a browser.\n- An account access token has no \"current user\"; calling with one returns 400.",
         "tag": "Fill",
         "method": "get",
         "path": "/fill/f/{form_token}",
@@ -4107,7 +5464,7 @@
     "getFillViewPage": {
         "operationId": "getFillViewPage",
         "summary": "Show a form view's fill page",
-        "description": "Reads the fill page behind a fill link (`/v/<token>`): its title, description, the fields to fill in, and whether the current user can submit right now.\nThe caller reads it as a submitter holding the link and needs no permission on the form or table; only what the fill page shows is returned.\n- `fields` lists the public fields in fill-page order, shaped like `fields` when reading a form; for a form view, column names, descriptions and required flags already follow the view's settings.\n- Submission is possible only when `status.key` is `open`; other values (such as `not_opened`, `closed`, `password_required`, `unauthorized`, `submission_prevented`,\n  `fill_frequency_limited`: the current user has used up the submissions the fill page allows) are explained in `status.message`; when the page is not yet open or has closed on schedule, `status.open_info` gives the open period.\n- `blockers` lists requirements only the submitter can complete on the page (captcha, SMS verification, WeChat identity, payment, etc.); when it is not empty, submission is refused and the form must be filled in a browser.\n- `manageable` is returned only when the current user can already read the underlying form or table, and gives its token and name.\n- An account access token has no \"current user\"; calling with one returns 400.",
+        "description": "Reads the fill page behind a fill link (`/v/<token>`): its title, description, the fields to fill in, and whether the current user can submit right now.\nThe caller reads it as a submitter holding the link and needs no permission on the form or table; only what the fill page shows is returned.\n- Submit through the API only when `status.key` is `open` and `blockers` is empty; otherwise `status.message` says why, and a non-empty `blockers` means the page must be filled in a browser.\n- An account access token has no \"current user\"; calling with one returns 400.",
         "tag": "Fill",
         "method": "get",
         "path": "/fill/v/{view_token}",
@@ -4182,5 +5539,248 @@
             "forms"
         ],
         "responseSchema": "TableFolderMoveResult"
+    },
+    "listRoutines": {
+        "operationId": "listRoutines",
+        "summary": "List routines",
+        "description": "The current user's own routines, newest first.\n- Paging: `next` is a row offset; pass it back unchanged for the next page. `skip` and `next` cannot be passed together. 50 per page by default, `limit` changes it (at most 1000).\n- Routines belong to a person: a credential with no current user (an account access token and the like) returns `403`, and so does an account that cannot use routines yet.",
+        "tag": "Routines",
+        "method": "get",
+        "path": "/routines",
+        "params": [
+            {
+                "name": "state",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "state",
+            "limit",
+            "next",
+            "skip"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "routines"
+        ],
+        "responseSchema": "RoutineListResponse"
+    },
+    "createRoutine": {
+        "operationId": "createRoutine",
+        "summary": "Create a routine",
+        "description": "Creates a routine, enabled from the start. The rules and messages are those of the routines page: a name of at most 60 characters, an instruction of at most 2000, only forms, tables, views and query pages you can reach as objects, at most 20 enabled routines per person, and a one-off time later than now. A data trigger's source is added to the objects.\n- A routine against the rules returns `422`, and `errors` gives each reason with its `code` and the page's message.\n- Delete authorization (`delete_authorized`) cannot be set here: a body that names it, true or false, returns `422` `delete_authorization_page_only` and creates nothing.\n- Jiri running a routine cannot create routines (`403`).",
+        "tag": "Routines",
+        "method": "post",
+        "path": "/routines",
+        "params": [],
+        "paramNames": [],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 201,
+        "scopes": [
+            "routines"
+        ],
+        "responseSchema": "Routine"
+    },
+    "getRoutine": {
+        "operationId": "getRoutine",
+        "summary": "Get a routine",
+        "description": "One of your own routines. Someone else's, or one that does not exist, returns `404`.",
+        "tag": "Routines",
+        "method": "get",
+        "path": "/routines/{id}",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "routines"
+        ],
+        "responseSchema": "Routine"
+    },
+    "updateRoutine": {
+        "operationId": "updateRoutine",
+        "summary": "Update a routine",
+        "description": "Changes the name, instruction, objects, trigger kind, schedule or data trigger. A key left out, or null, keeps what the routine has; `objects` given replaces them all.\n- The rules and messages are those of creating. A changed schedule cancels the runs queued for the old one; a changed instruction or objects stops a run in progress.\n- A body that names `delete_authorized`, true or false, returns `422` `delete_authorization_page_only` and changes nothing.\n- Jiri running a routine cannot update routines (`403`).",
+        "tag": "Routines",
+        "method": "patch",
+        "path": "/routines/{id}",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "id"
+        ],
+        "body": {
+            "contentType": "application/json",
+            "required": true,
+            "flatten": true
+        },
+        "successStatus": 200,
+        "scopes": [
+            "routines"
+        ],
+        "responseSchema": "Routine"
+    },
+    "deleteRoutine": {
+        "operationId": "deleteRoutine",
+        "summary": "Delete a routine",
+        "description": "Deletes the routine for good: it never runs again, and its queued and running runs are cancelled. The conversations of its past runs stay.\n- Jiri running a routine cannot delete routines (`403`).",
+        "tag": "Routines",
+        "method": "delete",
+        "path": "/routines/{id}",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "routines"
+        ]
+    },
+    "pauseRoutine": {
+        "operationId": "pauseRoutine",
+        "summary": "Pause a routine",
+        "description": "The routine stops running, and its queued and running runs are cancelled. Pausing a paused routine returns it as it is.\n- Jiri running a routine cannot pause routines (`403`).",
+        "tag": "Routines",
+        "method": "post",
+        "path": "/routines/{routine_id}/pause",
+        "params": [
+            {
+                "name": "routine_id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "routine_id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "routines"
+        ],
+        "responseSchema": "Routine"
+    },
+    "resumeRoutine": {
+        "operationId": "resumeRoutine",
+        "summary": "Resume a routine",
+        "description": "Enables a paused routine, which runs again from its next time after now; times missed while it was paused are not made up. Resuming an enabled routine returns it as it is.\n- As with creating, at most 20 routines can be enabled (`422` `active_limit`). A one-off whose time has passed returns `422` `once_passed`; a data trigger whose fields no longer work returns `422`.\n- Jiri running a routine cannot resume routines (`403`).",
+        "tag": "Routines",
+        "method": "post",
+        "path": "/routines/{routine_id}/resume",
+        "params": [
+            {
+                "name": "routine_id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "routine_id"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "routines"
+        ],
+        "responseSchema": "Routine"
+    },
+    "runRoutine": {
+        "operationId": "runRoutine",
+        "summary": "Run a routine now",
+        "description": "Queues one run now, paused routines included, and returns it. When it starts it is checked as a scheduled run is: AI points, the daily run limit, and access to the objects. Its outcome shows in the routine's runs.\n- A run still in progress returns `422` `invalid`; so does a data trigger whose fields no longer work.\n- Jiri running a routine cannot run routines (`403`).",
+        "tag": "Routines",
+        "method": "post",
+        "path": "/routines/{routine_id}/run",
+        "params": [
+            {
+                "name": "routine_id",
+                "in": "path",
+                "required": true
+            }
+        ],
+        "paramNames": [
+            "routine_id"
+        ],
+        "successStatus": 202,
+        "scopes": [
+            "routines"
+        ]
+    },
+    "listRoutineRuns": {
+        "operationId": "listRoutineRuns",
+        "summary": "List a routine's runs",
+        "description": "The runs of one of your own routines, latest planned time first. Paged as `GET /routines` is.",
+        "tag": "Routines",
+        "method": "get",
+        "path": "/routines/{routine_id}/runs",
+        "params": [
+            {
+                "name": "routine_id",
+                "in": "path",
+                "required": true
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "next",
+                "in": "query",
+                "required": false
+            },
+            {
+                "name": "skip",
+                "in": "query",
+                "required": false
+            }
+        ],
+        "paramNames": [
+            "routine_id",
+            "limit",
+            "next",
+            "skip"
+        ],
+        "successStatus": 200,
+        "scopes": [
+            "routines"
+        ],
+        "responseSchema": "RoutineRunListResponse"
     }
 }