飞书项目帮助中心

Appearance

Return to top
页面导航

更新子任务

请求体说明

类别值
请求地址{base_url}/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/workflow/:node_id/task/:task_id
请求方式POST

请求 Header

字段值必须填写
Content-Typeapplication/json必须
X-PLUGIN-TOKEN用户在开放平台中获取的 Token，参考插件身份凭证章节。必须
X-USER-KEY当选择使用插件身份凭证的时候，需要额外必选指定接口调用的用户user_key，user_key可双击用户头像获取可选
X-IDEM-UUID写类型接口的幂等串，可以不设置，设置后会进行同一个X-PLUGIN-TOKEN下同一接口的幂等判断可选

参考请求格式如下：

curl --location -g --request GET '{base_url}/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/workflow/task' \
--header 'X-PLUGIN-TOKEN: {{token}}' \
--header 'X-USER-KEY: {{user_key}}' \
--data-raw ''

路径参数

参数名是否必填值类型说明
project_key是string空间id [project_key]，或者空间域名 [simple_name]
work_item_type_key是string工作项类型，可以从 获取工作项类型 接口获取
work_item_id是int64目标工作项 ID
node_id是string目标节点state_key
task_id是int64目标任务ID

请求参数

参数名是否必填值类型说明
name是string子任务名称
alias_key否string目标节点对接标识
deliverable否list[FieldValuePair]交付物，只有子任务配置了交付物才能更新。
assignee否list[string]子任务负责人userKey列表，节点负责人类型为非角色负责人时可用
role_assignee否list[RoleOwner]子任务角色负责人列表，节点负责人类型为角色负责人时可用
schedule否Schedule子任务排期
note否string子任务备注

请求体格式 

{
    "name": "1234",
    "node_id": "doing",
    "note": "chayihua",
    "role_assignee":[
        {
            "role":"RD",
            "owners":["xxx"]
        }
    ],
    "schedule": {
        "points": 3,
        "estimate_start_date": 1639909559637,
        "estimate_end_date": 1639909559637,
        "owners": ["xxx"]
    },
    "deliverable" : [
        {
             "field_key" : "field_123" ,
             "field_value" : "test" 
        }
    ]
}

返回格式 

{
    "err": {},
    "err_code": 0,
    "err_msg": ""
}