TOOL API

smartsheet.update_field_type

修改单列的字段类型。相比 update_fields 更简单：绝大多数场景只需 (file_id, sheet_id, field_id, target_type) 四个参数，后端自动补齐 property（成员列自动补 C 端 property_user_c）、按 field_id 兜底 field_title（避 22030）、拒绝不支持的 twoWayLinkRecords/wwgroup、为 singleSelect/select 分配 option id。只在改为 formula/lookup/reference 等复杂列时需要在 extra 里带对应的属性。⚠️ 源列是 formula/lookup/reference/twoWayLinkRecords/autoNumber/user/wwgroup 时不支持改类型（值由引擎实时计算，转换会清空整列），请改用 add_fields 新列 + update_records 写值 + delete_fields 删旧列。系统列 createdUser/modifiedUser/createdTime/modifiedTime 可以直接改类型，原有值会保留（转换后成为普通静态值，不再随记录编辑自动更新） if both tencent-docs (personal) and tencent-docs-oa (enterprise) are connected, use AskUserQuestion to let the user pick the target account before invoking this tool.

productivityOAuth1 credits

Call information

Tool slug
tencent-docs.smartsheet.update_field_type
Provider
Tencent Docs
Average response
0 ms
Calls in 7 days
0

Input parameters

auto_number

仅当 target_type 为 autoNumber 时可选；留空则由系统按默认视图分配序号

field_idrequired

要修改类型的字段ID，通过 list_fields 获取。⚠️ 以下类型的列不支持改类型（原列值由引擎实时计算，无可迁移的实体值，强行转换会清空整列）：formula-公式、lookup-查找引用、reference-关联、twoWayLinkRecords-双向关联、autoNumber-自动编号、user-成员、wwgroup-企业群。如需把这些列的展示内容落成普通列，请改用：add_fields 新建目标类型列 → update_records 写入展示值 → delete_fields 删除原列。系统列 createdUser-创建人 / modifiedUser-最后编辑人 / createdTime-创建时间 / modifiedTime-最后编辑时间 可以直接改类型，原有值会保留（转换后成为普通静态值，不再随记录编辑自动更新）。

file_idrequired

智能表格文档的唯一标识符

formula

仅当 target_type 为 formula 时必传

lookup

仅当 target_type 为 lookup 时必传

reference

仅当 target_type 为 reference（关联）时必传

select_options

仅当 target_type 为 singleSelect / select 时使用。不传则创建空选项列。

sheet_idrequired

工作表ID

target_typerequired

目标列类型。枚举：text / number / url / phoneNumber / email / dateTime / checkbox / currency / percentage / singleSelect / select / progress / image / attachment / user / createdUser / modifiedUser / createdTime / modifiedTime / autoNumber / reference / formula / lookup。注：成员列用 'user'（本服务 C 端会自动补 property_user_c）；历史叫法 'userC' / 'user_c' 会被规范化回 'user'；'wwgroup' / 'twoWayLinkRecords' 不支持。另注：本参数是「目标」类型的白名单，与 field_id 里列出的「源」列类型限制是两件事——例如 formula 可以作为目标类型（原数据会被清空），但不能作为源类型。