# 说明

批量更新任务，返回任务更新后的数据

# url

https://api.tapd.cn/tasks/batch_update_task

JSON/XML（默认JSON格式）

POST

每次最多允许批量更新五十条数据

字段名	必选	类型及范围	说明
workspace_id	`是`	integer	项目ID
workitems	`是`	array	要更新对象数组（下面所有属性数组）
id	`是`	integer	ID
name	否	string	任务标题
description	否	string	任务详细描述
creator	否	string	创建人
status	否	string	状态
owner	否	string	任务当前处理人
current_user	否	string	操作人
cc	否	string	抄送人
begin	否	date	预计开始
due	否	date	预计结束
story_id	否	integer	关联需求的ID
iteration_id	否	integer	所属迭代的ID
priority	否	string	优先级
priority	否	string	优先级。为了兼容自定义优先级，`请使用 priority_label 字段`，详情参考：如何兼容自定义优先级
priority_label	否	string	优先级。推荐使用这个字段
effort	否	string	预估工时
auto_complete_effort	否	integer	是否自动补齐工时，取1时，并且状态流转到 done，就补齐
label	否	string	标签，标签不存在时将自动创建，多个以英文坚线分格
cus_{$自定义字段别名}	否	string	自定义字段值，参数名会由后台自动转义为custom_field_*，如：cus_这是一个自定义字段的名称
custom_field_*	否	string或者integer	自定义字段参数，具体字段名通过接口获取任务自定义字段配置获取

curl -u 'api_user:api_password' -d 'workspace_id=10158231&workitems=[{"id"=123123,"name"="测试“}]' 'https://api.tapd.cn/tasks/batch_update_task'

{
    "status": 1,
    "data": {
        "msg": "batch update success"
    },
    "info": "success"
}

1
2
3
4
5
6
7

为了兼容自定义优先级，请使用 priority_label 字段，详情参考：如何兼容自定义优先级。下面取值将不再使用。