# 批量更新待办任务



**标签**：`待办` 


## 请求说明
| 字段          | 值                  |
|--------------|---------------------|
| **<div style="white-space: nowrap;">请求地址</div>**  | https://openapi.wps.cn/v7/todo/tasks/batch_update          |
| **<div style="white-space: nowrap;">HTTP 方法</div>** | `POST`    |
| **<div style="white-space: nowrap;">接口描述</div>**  | 批量更新待办任务 |
| **<div style="white-space: nowrap;">签名方式</div>**  | [KSO-1](https://open.wps.cn/documents/app-integration-dev/wps365/server/api-description/signature-description) |
| **<div style="white-space: nowrap;">限频策略</div>** | 无 |
| **<div style="white-space: nowrap;">权限要求</div>** | <div><div>操作待办信息(应用授权) `kso.task.readwrite`</div></div> |


## 请求头 (Headers)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|-------|------|------|-------|-------|
| <div style="white-space: nowrap;">Content-Type</div> | `string` | 是 | 使用：'application/json'  | - 
| <div style="white-space: nowrap;">X-Kso-Date</div> | `string` | 是 | RFC1123 格式的日期，例: 'Wed, 23 Jan 2013 06:43:08 GMT'  | - 
| <div style="white-space: nowrap;">X-Kso-Authorization</div> | `string` | 是 | KSO-1 签名值 | - 
| <div style="white-space: nowrap;">Authorization</div> | `string` | 是 | 授权凭证，格式为：'Bearer {access_token}' | - 







## 请求体(Body)
**请求体格式:** `application/json`
<OpenapiRenderTable  dataSource='[{"key":"update_tasks","name":"update_tasks","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>待办任务列表</p>\n","children":[{"key":"update_tasks.items.data","name":"data","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>待办任务更新内容</p>\n","children":[{"key":"update_tasks.items.data.actions","name":"actions","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>操作行为</p>\n","children":[{"key":"update_tasks.items.data.actions.items.key","name":"key","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>回调key</p>\n","children":[]},{"key":"update_tasks.items.data.actions.items.link","name":"link","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>跳转url</p>\n","children":[{"key":"update_tasks.items.data.actions.items.link.mobile_url","name":"mobile_url","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>移动端跳转链接</p>\n","children":[]},{"key":"update_tasks.items.data.actions.items.link.pc_url","name":"pc_url","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>pc跳转链接</p>\n","children":[]}]},{"key":"update_tasks.items.data.actions.items.modal","name":"modal","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>弹窗设置</p>\n","children":[{"key":"update_tasks.items.data.actions.items.modal.desc","name":"desc","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>弹窗提示文本</p>\n","children":[]},{"key":"update_tasks.items.data.actions.items.modal.required","name":"required","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否必须填写理由</p>\n","children":[]},{"key":"update_tasks.items.data.actions.items.modal.title","name":"title","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>弹窗标题</p>\n","children":[]}]},{"key":"update_tasks.items.data.actions.items.style","name":"style","deprecated":false,"type":"string","required":"否","enum":["normal","secondary","disable"],"xEnum":["normal","secondary","disable"],"description":"<p>按钮样式</p>\n","children":[]},{"key":"update_tasks.items.data.actions.items.text","name":"text","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>按钮文本</p>\n","children":[]}]},{"key":"update_tasks.items.data.category_id","name":"category_id","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>待办分类id</p>\n","children":[]},{"key":"update_tasks.items.data.description","name":"description","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>待办描述</p>\n","children":[]},{"key":"update_tasks.items.data.display_time","name":"display_time","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>展示时间(预留,单位：毫秒)</p>\n","children":[]},{"key":"update_tasks.items.data.due_time","name":"due_time","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>截止时间(单位：毫秒)</p>\n","children":[]},{"key":"update_tasks.items.data.ext_attrs","name":"ext_attrs","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>预留扩展字段</p>\n","children":[{"key":"update_tasks.items.data.ext_attrs.items.name","name":"name","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>属性名</p>\n","children":[]},{"key":"update_tasks.items.data.ext_attrs.items.value","name":"value","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>属性值</p>\n","children":[]}]},{"key":"update_tasks.items.data.finish_time","name":"finish_time","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>完成时间(单位：毫秒)</p>\n","children":[]},{"key":"update_tasks.items.data.is_read","name":"is_read","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否已读</p>\n","children":[]},{"key":"update_tasks.items.data.link","name":"link","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>待办任务跳转链接</p>\n","children":[{"key":"update_tasks.items.data.link.mobile_url","name":"mobile_url","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>移动端跳转链接</p>\n","children":[]},{"key":"update_tasks.items.data.link.pc_url","name":"pc_url","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>pc跳转链接</p>\n","children":[]}]},{"key":"update_tasks.items.data.notify_config","name":"notify_config","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>提醒设置</p>\n","children":[{"key":"update_tasks.items.data.notify_config.reminders","name":"reminders","deprecated":false,"type":"array[object]","required":"否","enum":[],"xEnum":[],"description":"<p>推送人设置</p>\n","children":[{"key":"update_tasks.items.data.notify_config.reminders.items.before_due_time","name":"before_due_time","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>提前推送时间（单位：分）</p>\n","children":[]}]},{"key":"update_tasks.items.data.notify_config.switch","name":"switch","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>推送开关（默认开）</p>\n","children":[]}]},{"key":"update_tasks.items.data.priority","name":"priority","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>优先级id</p>\n","children":[]},{"key":"update_tasks.items.data.status","name":"status","deprecated":false,"type":"string","required":"否","enum":["todo","finish"],"xEnum":["todo","finish"],"description":"<p>待办状态</p>\n","children":[]},{"key":"update_tasks.items.data.tags","name":"tags","deprecated":false,"type":"array[string]","required":"否","enum":[],"xEnum":[],"description":"<p>标签</p>\n","children":[]},{"key":"update_tasks.items.data.title","name":"title","deprecated":false,"type":"object","required":"否","enum":[],"xEnum":[],"description":"<p>待办标题</p>\n","children":[{"key":"update_tasks.items.data.title.prefix","name":"prefix","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>前缀</p>\n","children":[]},{"key":"update_tasks.items.data.title.subject","name":"subject","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>主题</p>\n","children":[]}]}]},{"key":"update_tasks.items.task_id","name":"task_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>待办任务id</p>\n","children":[]}]}]' />

## 请求体示例
```json
{
  "update_tasks": [
    {
      "data": {
        "actions": [
          {
            "key": "string",
            "link": {
              "mobile_url": "string",
              "pc_url": "string"
            },
            "modal": {
              "desc": "string",
              "required": true,
              "title": "string"
            },
            "style": "normal",
            "text": "string"
          }
        ],
        "category_id": "string",
        "description": "string",
        "display_time": 0,
        "due_time": 0,
        "ext_attrs": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "finish_time": 0,
        "is_read": true,
        "link": {
          "mobile_url": "string",
          "pc_url": "string"
        },
        "notify_config": {
          "reminders": [
            {
              "before_due_time": 0
            }
          ],
          "switch": true
        },
        "priority": 0,
        "status": "todo",
        "tags": [
          "string"
        ],
        "title": {
          "prefix": "string",
          "subject": "string"
        }
      },
      "task_id": "string"
    }
  ]
}
```

## 响应体(Response)
**HTTP状态码:** `200`<br/>
**响应体格式:** `application/json`
<OpenapiRenderTable hideHeaderKeys='required' dataSource='[{"key":"code","name":"code","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"-","children":[]},{"key":"msg","name":"msg","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>人可阅读的文本信息，可能会按不同的语言或地区返回不同的文本信息。</p>\n","children":[]}]' />

## 响应体示例
```json
{
  "code": 0,
  "msg": "string"
}
```