更新任务

该接口用于修改任务的标题、描述、截止时间等信息。

更新时，将update_fields字段中填写所有要修改的任务字段名，同时在task字段中填写要修改的字段的新值即可。如果update_fields中设置了要变更一个字段的名字，但是task里没设置新的值，则表示将该字段清空。调用约定详情见功能概述中的“ 关于资源的更新”章节。

该接口可以用于完成任务和将任务恢复至未完成，只需要修改completed_at字段即可。但留意，目前不管任务本身是会签任务还是或签任务，oapi对任务进行完成只能实现“整体完成”，不支持个人单独完成。此外，不能对已经完成的任务再次完成，但可以将其恢复到未完成的状态(设置completed_at为"0")。

如更新自定义字段的值，需要调用身份同时拥有任务的编辑权限和自定义字段的编辑权限。详情见自定义字段功能概览。更新时，只有填写在task.custom_fields的自定义字段值会被更新，不填写的不会被改变。

任务成员/提醒/清单数据不能使用本接口进行更新。

如要修改任务成员，需要使用添加任务成员和移除任务成员接口。
如要修改任务提醒，需要使用添加任务提醒和移除任务提醒接口。
如要变更任务所在的清单，需要使用任务加入清单和任务移出清单接口。

Tip: 修改时需要调用身份对任务有编辑权限。详情见任务功能概述中的“任务是如何鉴权的？”章节。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/task/v2/tasks/:task_guid
HTTP Method	PATCH
接口频率限制	10 次/秒
支持的应用类型	custom,isv
权限要求调用该 API 所需的权限。开启其中任意一项权限即可调用开启任一权限即可	`task:task:write` 查看、创建、更新、删除任务 `task:task:writeonly` 创建、更新任务

请求头

名称	类型	必填	描述
Authorization	string	是	`tenant_access_token` 或 `user_access_token` 值格式："Bearer `access_token`" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

路径参数

名称	类型	描述
`task_guid`	`string`	要更新的任务全局唯一ID 示例值："e297ddff-06ca-4166-b917-4ce57cd3a7a0" 数据校验规则： - 最大长度：`100` 字符

查询参数

名称	类型	必填	描述
`user_id_type`	`string`	否	用户 ID 类型示例值：open_id 默认值：`open_id`

请求体

名称	类型	必填	描述
`task`	`input_task`	否	要更新的任务数据，只需要设置出现在`update_fields`中的字段即可。如果`update_fields`设置了要变更一个字段名，但是`task`里没设置新的值，则表示将该字段清空。
└ `summary`	`string`	否	任务标题。如更新标题，不可将任务标题设为空。标题最大支持3000个utf8 字符。示例值："针对全年销售进行一次复盘"
└ `description`	`string`	否	任务描述。描述最大支持3000个utf8字符。示例值："需要事先阅读复盘总结文档"
└ `due`	`due`	否	任务截止时间。详见功能概述中的“ 如何使用开始时间和截止时间？”章节。示例值：1675742789470
└ `timestamp`	`string`	否	截止时间/日期的时间戳，距1970-01-01 00:00:00的毫秒数。如果截止时间是一个日期，需要把日期转换成时间戳，并设置 is_all_day=true 示例值："1675454764000"
└ `is_all_day`	`boolean`	否	是否截止到一个日期。如果设为true，timestamp中只有日期的部分会被解析和存储。示例值：true
└ `extra`	`string`	否	调用者可以传入的任意附带到任务上的数据。在获取任务详情时会原样返回。示例值："dGVzdA==" 数据校验规则： - 最大长度：`65536` 字符
└ `completed_at`	`string`	否	任务的完成时刻时间戳(ms) 示例值："1675742789470" 默认值：`0` 数据校验规则： - 最大长度：`20` 字符
└ `repeat_rule`	`string`	否	如果设置，则该任务为“重复任务”。详见任务功能概述中的“如何使用重复任务？”章节。示例值："FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR" 数据校验规则： - 最大长度：`1000` 字符
└ `custom_complete`	`custom_complete`	否	任务自定义完成配置。详见任务功能概述中的“ 如何使用任务自定义完成？”章节。
└ `pc`	`custom_complete_item`	否	pc客户端自定义完成配置（含mac和windows）
└ `href`	`string`	否	自定义完成的跳转url 示例值："https://www.example.com"
└ `tip`	`i18n_text`	否	自定义完成的弹出提示为
└ `en_us`	`string`	否	英文示例值："workbench" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_cn`	`string`	否	中文示例值："工作台" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_hk`	`string`	否	中文（香港地区）示例值："工作臺" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_tw`	`string`	否	中文（台湾地区）示例值："工作臺" 数据校验规则： - 最大长度：`1000` 字符
└ `ja_jp`	`string`	否	日语示例值："作業台" 数据校验规则： - 最大长度：`1000` 字符
└ `fr_fr`	`string`	否	法语示例值："Table de travail"
└ `it_it`	`string`	否	意大利语示例值："banco di lavoro"
└ `de_de`	`string`	否	德语示例值："Werkbank"
└ `ru_ru`	`string`	否	俄语示例值："верстак"
└ `th_th`	`string`	否	泰语示例值："โต๊ะทำงาน"
└ `es_es`	`string`	否	西班牙语示例值："banco de trabajo"
└ `ko_kr`	`string`	否	韩语示例值："작업대"
└ `ios`	`custom_complete_item`	否	ios端的自定义完成配置
└ `href`	`string`	否	自定义完成的跳转url 示例值："https://www.example.com"
└ `tip`	`i18n_text`	否	自定义完成的弹出提示为
└ `en_us`	`string`	否	英文示例值："workbench" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_cn`	`string`	否	中文示例值："工作台" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_hk`	`string`	否	中文（香港地区）示例值："工作臺" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_tw`	`string`	否	中文（台湾地区）示例值："工作臺" 数据校验规则： - 最大长度：`1000` 字符
└ `ja_jp`	`string`	否	日语示例值："作業台" 数据校验规则： - 最大长度：`1000` 字符
└ `fr_fr`	`string`	否	法语示例值："Table de travail"
└ `it_it`	`string`	否	意大利语示例值："banco di lavoro"
└ `de_de`	`string`	否	德语示例值："Werkbank"
└ `ru_ru`	`string`	否	俄语示例值："верстак"
└ `th_th`	`string`	否	泰语示例值："โต๊ะทำงาน"
└ `es_es`	`string`	否	西班牙语示例值："banco de trabajo"
└ `ko_kr`	`string`	否	韩语示例值："작업대"
└ `android`	`custom_complete_item`	否	android端的自定义完成配置
└ `href`	`string`	否	自定义完成的跳转url 示例值："https://www.example.com"
└ `tip`	`i18n_text`	否	自定义完成的弹出提示为
└ `en_us`	`string`	否	英文示例值："workbench" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_cn`	`string`	否	中文示例值："工作台" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_hk`	`string`	否	中文（香港地区）示例值："工作臺" 数据校验规则： - 最大长度：`1000` 字符
└ `zh_tw`	`string`	否	中文（台湾地区）示例值："工作臺" 数据校验规则： - 最大长度：`1000` 字符
└ `ja_jp`	`string`	否	日语示例值："作業台" 数据校验规则： - 最大长度：`1000` 字符
└ `fr_fr`	`string`	否	法语示例值："Table de travail"
└ `it_it`	`string`	否	意大利语示例值："banco di lavoro"
└ `de_de`	`string`	否	德语示例值："Werkbank"
└ `ru_ru`	`string`	否	俄语示例值："верстак"
└ `th_th`	`string`	否	泰语示例值："โต๊ะทำงาน"
└ `es_es`	`string`	否	西班牙语示例值："banco de trabajo"
└ `ko_kr`	`string`	否	韩语示例值："작업대"
└ `start`	`start`	否	任务的开始时间(ms)。详见功能概述中的“ 如何使用开始时间和截止时间？”章节。
└ `timestamp`	`string`	否	开始时间的时间戳，距1970-01-01 00:00:00的毫秒数。如果开始时间是一个日期，需要把日期转换成时间戳，并设置 is_all_day=true 示例值："1675454764000"
└ `is_all_day`	`boolean`	否	是否开始于一个日期。如果设为true，timestamp中只有日期的部分会被解析和存储。示例值：true
└ `mode`	`int`	否	任务的完成模式。1 - 会签任务；2 - 或签任务示例值：2 数据校验规则： - 取值范围：`1` ～ `2`
└ `is_milestone`	`boolean`	否	是否是里程碑任务示例值：false
└ `custom_fields`	`input_custom_field_value\[\]`	否	自定义字段值。如要更新，每个字段的值根据字段类型填写相应的字段。 * 当`type`为"number"时，应使用`number_value`字段，表示数字类型自定义字段的值； * 当`type`为"member"时，应使用`member_value`字段，表示人员类型自定义字段的值； * 当`type`为"datetime"时，应使用`datetime_value`字段，表示日期类型自定义字段的值； * 当`type`为"single_select"时，应使用`single_select_value`字段，表示单选类型自定义字段的值； * 当`type`为"multi_select"时，应使用`multi_select_value`字段，表示多选类型自定义字段的值； * 当`type`为"text"时，应使用`text_value`字段，表示文本类型自定义字段的值。
└ `guid`	`string`	是	自定义字段guid 示例值："73b21903-0041-4796-a11e-f8be919a7063"
└ `number_value`	`string`	否	数字类型的自定义字段值，填写一个合法数字的字符串表示，空字符串表示设为空。示例值："10.23" 数据校验规则： - 最大长度：`20` 字符
└ `member_value`	`member\[\]`	否	人员类型的自定义字段值。可以设置1个或多个用户的id（遵循member格式，只支持user类型）。当字段设为只不能多选时只能输入一个值。设为空数组表示设为空。数据校验规则： - 最大长度：`50`
└ `id`	`string`	否	表示member的id 示例值："ou_2cefb2f014f8d0c6c2d2eb7bafb0e54f" 数据校验规则： - 最大长度：`100` 字符
└ `type`	`string`	否	成员的类型示例值："user" 默认值：`user`
└ `name`	`string`	否	成员名称示例值："张明德（明德）"
└ `datetime_value`	`string`	否	日期类型自定义字段值，可以输入一个表示日期的以毫秒为单位的字符串。设为空字符串表示设为空。示例值："1698192000000"
└ `single_select_value`	`string`	否	单选类型字段值，填写一个字段选项的option_guid。设置为空字符串表示设为空。示例值："73b21903-0041-4796-a11e-f8be919a7063" 数据校验规则： - 最大长度：`100` 字符
└ `multi_select_value`	`string\[\]`	否	多选类型字段值，可以填写一个或多个本字段的option_guid。设为空数组表示设为空。示例值：["73b21903-0041-4796-a11e-f8be919a7063"] 数据校验规则： - 最大长度：`50`
└ `text_value`	`string`	否	文本类型字段值。可以填写最多3000字符。使用空字符串表示设为空。示例值："文本类型字段值。可以输入一段文本。空字符串表示清空。"
`update_fields`	`string\[\]`	是	设置需要修改的字段 - `summary`: 任务标题 - `description`: 任务描述 - `start`: 任务开始时间 - `due`: 任务截止时间 - `completed_at`: 任务完成时间 - `extra`: 任务附属自定义数据 - `custom_complete`: 任务自定义完成规则 - `repeat_rule`: 任务重复规则 - `mode`: 任务完成模式 - `is_milestone`: 是否是里程碑任务 - `custom_fields"`: 自定义字段值示例值：["summary"]

请求体示例

json

{
    "task": {
        "summary": "针对全年销售进行一次复盘",
        "description": "需要事先阅读复盘总结文档",
        "due": {
            "timestamp": "1675454764000",
            "is_all_day": true
        },
        "extra": "dGVzdA==",
        "completed_at": "1675742789470",
        "repeat_rule": "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR",
        "custom_complete": {
            "pc": {
                "href": "https://www.example.com",
                "tip": {
                    "en_us": "workbench",
                    "zh_cn": "工作台",
                    "zh_hk": "工作臺",
                    "zh_tw": "工作臺",
                    "ja_jp": "作業台",
                    "fr_fr": "Table de travail",
                    "it_it": "banco di lavoro",
                    "de_de": "Werkbank",
                    "ru_ru": "верстак",
                    "th_th": "โต๊ะทำงาน",
                    "es_es": "banco de trabajo",
                    "ko_kr": "작업대"
                }
            },
            "ios": {
                "href": "https://www.example.com",
                "tip": {
                    "en_us": "workbench",
                    "zh_cn": "工作台",
                    "zh_hk": "工作臺",
                    "zh_tw": "工作臺",
                    "ja_jp": "作業台",
                    "fr_fr": "Table de travail",
                    "it_it": "banco di lavoro",
                    "de_de": "Werkbank",
                    "ru_ru": "верстак",
                    "th_th": "โต๊ะทำงาน",
                    "es_es": "banco de trabajo",
                    "ko_kr": "작업대"
                }
            },
            "android": {
                "href": "https://www.example.com",
                "tip": {
                    "en_us": "workbench",
                    "zh_cn": "工作台",
                    "zh_hk": "工作臺",
                    "zh_tw": "工作臺",
                    "ja_jp": "作業台",
                    "fr_fr": "Table de travail",
                    "it_it": "banco di lavoro",
                    "de_de": "Werkbank",
                    "ru_ru": "верстак",
                    "th_th": "โต๊ะทำงาน",
                    "es_es": "banco de trabajo",
                    "ko_kr": "작업대"
                }
            }
        },
        "start": {
            "timestamp": "1675454764000",
            "is_all_day": true
        },
        "mode": 2,
        "is_milestone": false,
        "custom_fields": [
            {
                "guid": "73b21903-0041-4796-a11e-f8be919a7063",
                "number_value": "10.23",
                "member_value": [
                    {
                        "id": "ou_2cefb2f014f8d0c6c2d2eb7bafb0e54f",
                        "type": "user",
                        "name": "张明德（明德）"
                    }
                ],
                "datetime_value": "1698192000000",
                "single_select_value": "73b21903-0041-4796-a11e-f8be919a7063",
                "multi_select_value": [
                    "73b21903-0041-4796-a11e-f8be919a7063"
                ],
                "text_value": "文本类型字段值。可以输入一段文本。空字符串表示清空。"
            }
        ]
    },
    "update_fields": [
        "summary"
    ]
}

响应

响应体

名称	类型	描述
`code`	`int`	错误码，非 0 表示失败
`msg`	`string`	错误描述
`data`	`\-`	-
└ `task`	`task`	更新后的任务
└ `guid`	`string`	任务guid，任务的唯一ID
└ `summary`	`string`	任务标题
└ `description`	`string`	任务描述
└ `due`	`due`	任务截止时间
└ `timestamp`	`string`	截止时间/日期的时间戳，距1970-01-01 00:00:00的毫秒数。如果截止时间是一个日期，需要把日期转换成时间戳，并设置 is_all_day=true
└ `is_all_day`	`boolean`	是否截止到一个日期。如果设为true，timestamp中只有日期的部分会被解析和存储。
└ `reminders`	`reminder\[\]`	任务的提醒配置列表。目前每个任务最多有1个。
└ `id`	`string`	提醒时间设置的 ID
└ `relative_fire_minute`	`int`	相对于截止时间的提醒时间分钟数。例如30表示截止时间前30分钟提醒；0表示截止时提醒。
└ `creator`	`member`	任务创建者
└ `id`	`string`	表示member的id
└ `type`	`string`	成员的类型
└ `role`	`string`	任务角色
└ `name`	`string`	成员名称
└ `members`	`member\[\]`	任务成员列表
└ `id`	`string`	表示member的id
└ `type`	`string`	成员的类型
└ `role`	`string`	任务角色
└ `name`	`string`	成员名称
└ `completed_at`	`string`	任务完成的时间戳(ms)
└ `attachments`	`attachment\[\]`	任务的附件列表
└ `guid`	`string`	附件guid
└ `file_token`	`string`	附件在云文档系统中的token
└ `name`	`string`	附件名
└ `size`	`int`	附件的字节大小
└ `resource`	`resource`	附件归属的资源
└ `type`	`string`	资源类型
└ `id`	`string`	资源ID
└ `uploader`	`member`	附件上传者
└ `id`	`string`	表示member的id
└ `type`	`string`	成员的类型
└ `role`	`string`	任务角色
└ `name`	`string`	成员名称
└ `is_cover`	`boolean`	是否是封面图
└ `uploaded_at`	`string`	上传时间戳(ms)
└ `origin`	`origin`	任务关联的第三方平台来源信息。创建是设置后就不可更改。
└ `platform_i18n_name`	`i18n_text`	任务导入来源的名称，用于在任务中心详情页展示。需提供多语言版本。
└ `en_us`	`string`	英文
└ `zh_cn`	`string`	中文
└ `zh_hk`	`string`	中文（香港地区）
└ `zh_tw`	`string`	中文（台湾地区）
└ `ja_jp`	`string`	日语
└ `fr_fr`	`string`	法语
└ `it_it`	`string`	意大利语
└ `de_de`	`string`	德语
└ `ru_ru`	`string`	俄语
└ `th_th`	`string`	泰语
└ `es_es`	`string`	西班牙语
└ `ko_kr`	`string`	韩语
└ `href`	`href`	任务关联的来源平台详情页链接
└ `url`	`string`	链接对应的地址，如填写必须以https://或http😕/开头
└ `title`	`string`	链接对应的标题
└ `extra`	`string`	任务附带的自定义数据。
└ `tasklists`	`task_in_tasklist_info\[\]`	任务所属清单的名字。调用者只能看到有权限访问的清单的列表。
└ `tasklist_guid`	`string`	任务所在清单的guid
└ `section_guid`	`string`	任务所在清单的自定义分组guid
└ `repeat_rule`	`string`	如果任务为重复任务，返回重复任务的配置
└ `parent_task_guid`	`string`	如果当前任务为某个任务的子任务，返回父任务的guid
└ `mode`	`int`	任务的模式。1 - 会签任务；2 - 或签任务
└ `source`	`int`	任务创建的来源可选值有： - `0`: 未知来源 - `1`: 任务中心 - `2`: 群组任务/消息转任务 - `6`: 通过开放平台以tenant_access_token授权创建的任务 - `7`: 通过开放平台以user_access_token授权创建的任务 - `8`: 文档任务
└ `custom_complete`	`custom_complete`	任务的自定义完成配置
└ `pc`	`custom_complete_item`	pc客户端自定义完成配置（含mac和windows）
└ `href`	`string`	自定义完成的跳转url
└ `tip`	`i18n_text`	自定义完成的弹出提示为
└ `en_us`	`string`	英文
└ `zh_cn`	`string`	中文
└ `zh_hk`	`string`	中文（香港地区）
└ `zh_tw`	`string`	中文（台湾地区）
└ `ja_jp`	`string`	日语
└ `fr_fr`	`string`	法语
└ `it_it`	`string`	意大利语
└ `de_de`	`string`	德语
└ `ru_ru`	`string`	俄语
└ `th_th`	`string`	泰语
└ `es_es`	`string`	西班牙语
└ `ko_kr`	`string`	韩语
└ `ios`	`custom_complete_item`	ios端的自定义完成配置
└ `href`	`string`	自定义完成的跳转url
└ `tip`	`i18n_text`	自定义完成的弹出提示为
└ `en_us`	`string`	英文
└ `zh_cn`	`string`	中文
└ `zh_hk`	`string`	中文（香港地区）
└ `zh_tw`	`string`	中文（台湾地区）
└ `ja_jp`	`string`	日语
└ `fr_fr`	`string`	法语
└ `it_it`	`string`	意大利语
└ `de_de`	`string`	德语
└ `ru_ru`	`string`	俄语
└ `th_th`	`string`	泰语
└ `es_es`	`string`	西班牙语
└ `ko_kr`	`string`	韩语
└ `android`	`custom_complete_item`	android端的自定义完成配置
└ `href`	`string`	自定义完成的跳转url
└ `tip`	`i18n_text`	自定义完成的弹出提示为
└ `en_us`	`string`	英文
└ `zh_cn`	`string`	中文
└ `zh_hk`	`string`	中文（香港地区）
└ `zh_tw`	`string`	中文（台湾地区）
└ `ja_jp`	`string`	日语
└ `fr_fr`	`string`	法语
└ `it_it`	`string`	意大利语
└ `de_de`	`string`	德语
└ `ru_ru`	`string`	俄语
└ `th_th`	`string`	泰语
└ `es_es`	`string`	西班牙语
└ `ko_kr`	`string`	韩语
└ `task_id`	`string`	任务界面上的代码
└ `created_at`	`string`	任务创建时间戳(ms)
└ `updated_at`	`string`	任务最后一次更新的时间戳(ms)
└ `status`	`string`	任务的状态，支持"todo"和"done"两种状态
└ `url`	`string`	任务的分享链接
└ `start`	`start`	任务的开始时间
└ `timestamp`	`string`	开始时间/日期的时间戳，距1970-01-01 00:00:00的毫秒数。如果开始时间是一个日期，需要把日期转换成时间戳，并设置 is_all_day=true
└ `is_all_day`	`boolean`	是否开始于一个日期。如果设为true，timestamp中只有日期的部分会被解析和存储。
└ `subtask_count`	`int`	该任务的子任务的个数。
└ `is_milestone`	`boolean`	是否是里程碑任务
└ `custom_fields`	`custom_field_value\[\]`	任务的自定义字段值
└ `guid`	`string`	字段GUID
└ `type`	`string`	自定义字段类型，支持"member", "datetime", "number", "single_select", "multi_select"五种类型
└ `number_value`	`string`	数字类型的自定义字段值，填写一个合法数字的字符串表示，空字符串表示设为空。
└ `datetime_value`	`string`	日期类型自定义字段值。可以输入一个表示日期的以毫秒为单位的字符串。设为空字符串表示设为空。
└ `member_value`	`member\[\]`	人员类型的自定义字段值，可以设置1个或多个用户的id（遵循member格式，只支持user类型）。当该字段的设置为“不能多选”时只能输入一个值。设为空数组表示设为空。
└ `id`	`string`	表示member的id
└ `type`	`string`	成员的类型
└ `role`	`string`	成员角色
└ `name`	`string`	成员名称
└ `single_select_value`	`string`	单选类型字段值，填写一个字段选项的option_guid。设置为空字符串表示设为空。
└ `multi_select_value`	`string\[\]`	多选类型字段值，可以填写一个或多个本字段的option_guid。设为空数组表示设为空。
└ `name`	`string`	自定义字段名
└ `text_value`	`string`	文本类型字段值。可以输入一段文本。空字符串表示清空。
└ `dependencies`	`task_dependency\[\]`	任务依赖
└ `type`	`string`	依赖类型可选值有： - `prev`: 前置依赖 - `next`: 后置依赖
└ `task_guid`	`string`	依赖任务的GUID
└ `assignee_related`	`task_assignee\[\]`	任务执行者相关信息，如会签任务各执行者完成时间等
└ `id`	`string`	任务执行者的id
└ `completed_at`	`string`	会签任务中执行者完成的时间戳(ms)

响应体示例

json

{
    "code": 0,
    "msg": "success",
    "data": {
        "task": {
            "guid": "83912691-2e43-47fc-94a4-d512e03984fa",
            "summary": "进行销售年中总结",
            "description": "进行销售年中总结",
            "due": {
                "timestamp": "1675454764000",
                "is_all_day": true
            },
            "reminders": [
                {
                    "id": "10",
                    "relative_fire_minute": 30
                }
            ],
            "creator": {
                "id": "ou_2cefb2f014f8d0c6c2d2eb7bafb0e54f",
                "type": "user",
                "role": "assignee",
                "name": "张明德（明德）"
            },
            "members": [
                {
                    "id": "ou_2cefb2f014f8d0c6c2d2eb7bafb0e54f",
                    "type": "user",
                    "role": "assignee",
                    "name": "张明德（明德）"
                }
            ],
            "completed_at": "1675742789470",
            "attachments": [
                {
                    "guid": "f860de3e-6881-4ddd-9321-070f36d1af0b",
                    "file_token": "boxcnTDqPaRA6JbYnzQsZ2doB2b",
                    "name": "foo.jpg",
                    "size": 62232,
                    "resource": {
                        "type": "task",
                        "id": "e6e37dcc-f75a-5936-f589-12fb4b5c80c2"
                    },
                    "uploader": {
                        "id": "ou_2cefb2f014f8d0c6c2d2eb7bafb0e54f",
                        "type": "user",
                        "role": "editor",
                        "name": "张明德（明德）"
                    },
                    "is_cover": false,
                    "uploaded_at": "1675742789470"
                }
            ],
            "origin": {
                "platform_i18n_name": {
                    "en_us": "workbench",
                    "zh_cn": "工作台",
                    "zh_hk": "工作臺",
                    "zh_tw": "工作臺",
                    "ja_jp": "作業台",
                    "fr_fr": "Table de travail",
                    "it_it": "banco di lavoro",
                    "de_de": "Werkbank",
                    "ru_ru": "верстак",
                    "th_th": "โต๊ะทำงาน",
                    "es_es": "banco de trabajo",
                    "ko_kr": "작업대"
                },
                "href": {
                    "url": "https://www.example.com",
                    "title": "反馈一个问题，需要协助排查"
                }
            },
            "extra": "dGVzdA==",
            "tasklists": [
                {
                    "tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
                    "section_guid": "e6e37dcc-f75a-5936-f589-12fb4b5c80c2"
                }
            ],
            "repeat_rule": "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR",
            "parent_task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
            "mode": 2,
            "source": 6,
            "custom_complete": {
                "pc": {
                    "href": "https://www.example.com",
                    "tip": {
                        "en_us": "workbench",
                        "zh_cn": "工作台",
                        "zh_hk": "工作臺",
                        "zh_tw": "工作臺",
                        "ja_jp": "作業台",
                        "fr_fr": "Table de travail",
                        "it_it": "banco di lavoro",
                        "de_de": "Werkbank",
                        "ru_ru": "верстак",
                        "th_th": "โต๊ะทำงาน",
                        "es_es": "banco de trabajo",
                        "ko_kr": "작업대"
                    }
                },
                "ios": {
                    "href": "https://www.example.com",
                    "tip": {
                        "en_us": "workbench",
                        "zh_cn": "工作台",
                        "zh_hk": "工作臺",
                        "zh_tw": "工作臺",
                        "ja_jp": "作業台",
                        "fr_fr": "Table de travail",
                        "it_it": "banco di lavoro",
                        "de_de": "Werkbank",
                        "ru_ru": "верстак",
                        "th_th": "โต๊ะทำงาน",
                        "es_es": "banco de trabajo",
                        "ko_kr": "작업대"
                    }
                },
                "android": {
                    "href": "https://www.example.com",
                    "tip": {
                        "en_us": "workbench",
                        "zh_cn": "工作台",
                        "zh_hk": "工作臺",
                        "zh_tw": "工作臺",
                        "ja_jp": "作業台",
                        "fr_fr": "Table de travail",
                        "it_it": "banco di lavoro",
                        "de_de": "Werkbank",
                        "ru_ru": "верстак",
                        "th_th": "โต๊ะทำงาน",
                        "es_es": "banco de trabajo",
                        "ko_kr": "작업대"
                    }
                }
            },
            "task_id": "t6272302",
            "created_at": "1675742789470",
            "updated_at": "1675742789470",
            "status": "todo",
            "url": "https://applink.feishu.cn/client/todo/detail?guid=70577c8f-91ab-4c91-b359-a21a751054e8&suite_entity_num=t192012",
            "start": {
                "timestamp": "1675454764000",
                "is_all_day": true
            },
            "subtask_count": 1,
            "is_milestone": false,
            "custom_fields": [
                {
                    "guid": "a4f648d7-76ef-477f-bc8e-0601b5a60093",
                    "type": "number",
                    "number_value": "10.23",
                    "datetime_value": "1687708260000",
                    "member_value": [
                        {
                            "id": "ou_2cefb2f014f8d0c6c2d2eb7bafb0e54f",
                            "type": "user",
                            "role": "editor",
                            "name": "张明德（明德）"
                        }
                    ],
                    "single_select_value": "4216f79b-3fda-4dc6-a0c4-a16022e47152",
                    "multi_select_value": [
                        "4216f79b-3fda-4dc6-a0c4-a16022e47152"
                    ],
                    "name": "优先级",
                    "text_value": "这是一段文本介绍。"
                }
            ],
            "dependencies": [
                {
                    "type": "next",
                    "task_guid": "93b7bd05-35e6-4371-b3c9-6b7cbd7100c0"
                }
            ],
            "assignee_related": [
                {
                    "id": "ou_2cefb2f014f8d0c6c2d2eb7bafb0e54f",
                    "completed_at": "1675742789470"
                }
            ]
        }
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1470400	请求参数错误，如提供的任务GUID不合法，尝试将任务标题设为空等。	错误原因见返回的msg提示的信息。
404	1470404	任务数据不存在或者已删除。	确认要访问的任务数据是否存在或已删除。
500	1470500	服务器错误。	尝试重试调用。如持续失败，请联系支持人员进行反馈。常见问题参考: 1. OpenAPI接口对任务进行完成只能实现“整体完成”，不支持个人单独完成，因此对于会签任务而言，只能任务创建人可以更新complete_at字段。 2. 检查任务标题或描述内容是否存在非法内容，非法内容无法通过安全内容检查。
403	1470403	缺少对任务的可编辑权限。	检查调用身份是否对任务有编辑权限。详情见任务功能概述中的“任务是如何鉴权的？”章节。

更新任务 ​

请求 ​

请求头 ​

路径参数 ​

查询参数 ​

请求体 ​

请求体示例 ​

响应 ​

响应体 ​

响应体示例 ​

错误码 ​

更新任务

请求

请求头

路径参数

查询参数

请求体

请求体示例

响应

响应体

响应体示例

错误码