# 更新任务 该接口用于修改任务的标题、描述、截止时间等信息。 更新时，将`update_fields`字段中填写所有要修改的任务字段名，同时在`task`字段中填写要修改的字段的新值即可。如果`update_fields`中设置了要变更一个字段的名字，但是task里没设置新的值，则表示将该字段清空。调用约定详情见[功能概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/overview)中的“ 关于资源的更新”章节。 该接口可以用于完成任务和将任务恢复至未完成，只需要修改`completed_at`字段即可。但留意，目前不管任务本身是会签任务还是或签任务，oapi对任务进行完成只能实现“整体完成”，不支持个人单独完成。此外，不能对已经完成的任务再次完成，但可以将其恢复到未完成的状态(设置`completed_at`为"0")。 如更新自定义字段的值，需要调用身份同时拥有任务的编辑权限和自定义字段的编辑权限。详情见[自定义字段功能概览](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/custom_field/custom-field-overview)。更新时，只有填写在`task.custom_fields`的自定义字段值会被更新，不填写的不会被改变。 任务成员/提醒/清单数据不能使用本接口进行更新。 * 如要修改任务成员，需要使用[添加任务成员](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/add_members) 和[移除任务成员](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/remove_members)接口。 * 如要修改任务提醒，需要使用[添加任务提醒](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/add_reminders)和[移除任务提醒](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/remove_reminders)接口。 * 如要变更任务所在的清单，需要使用[任务加入清单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/add_tasklist)和[任务移出清单]( https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/remove_tasklist)接口。 **注意事项**：修改时需要调用身份对任务有编辑权限。详情见[任务功能概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/overview)中的“任务是如何鉴权的？”章节。 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/task/v2/tasks/:task_guid HTTP Method | PATCH 接口频率限制 | [10 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App、Store App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用**
开启任一权限即可 | 查看、创建、更新、删除任务(task:task:write)
创建、更新任务(task:task:writeonly) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
或
`user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) 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 | 否 | 任务截止时间。详见[功能概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/overview)中的“ 如何使用开始时间和截止时间？”章节。
**示例值**：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 | 否 | 如果设置，则该任务为“重复任务”。详见[任务功能概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/overview)中的“如何使用重复任务？”章节。
**示例值**："FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR"
**数据校验规则**：
- 最大长度：`1000` 字符 custom_complete | custom_complete | 否 | 任务自定义完成配置。详见[任务功能概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/overview)中的“ 如何使用任务自定义完成？”章节。 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)。详见[功能概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/overview)中的“ 如何使用开始时间和截止时间？”章节。 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：是否是里程碑任务
- key=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 | 缺少对任务的可编辑权限。 | 检查调用身份是否对任务有编辑权限。详情见[任务功能概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/task/overview)中的“任务是如何鉴权的？”章节。