添加依赖

为一个任务添加一个或多个依赖。可以添加任务的前置依赖和后置依赖。存在依赖关系的任务如果在同一个清单，可以通过清单的甘特图来展示其依赖关系。

本接口也可以用于修改一个现有依赖的类型（前置改为后置或者后置改为前置）。

注意：添加的依赖的task_guid不能重复，也不能添加当前任务为自己的依赖。尝试添加一个已经存在的依赖会被自动忽略。

Tip: 添加任务依赖需要调用身份拥有当前任务的编辑权限和所有被添加为依赖的任务的编辑权限。

请求

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

请求头

名称	类型	必填	描述
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	任务GUID 示例值："93b7bd05-35e6-4371-b3c9-6b7cbd7100c0"

请求体

名称	类型	必填	描述
dependencies	task_dependency\[\]	否	要添加的依赖 数据校验规则： - 长度范围：1 ～ 50
└ type	string	是	依赖类型 示例值："next" 可选值有： - prev: 前置依赖 - next: 后置依赖
└ task_guid	string	是	依赖任务的GUID 示例值："93b7bd05-35e6-4371-b3c9-6b7cbd7100c0"

请求体示例

{
    "dependencies": [
        {
            "type": "next",
            "task_guid": "93b7bd05-35e6-4371-b3c9-6b7cbd7100c0"
        }
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ dependencies	task_dependency\[\]	被添加后任务的所有依赖
└ type	string	依赖类型 可选值有： - prev: 前置依赖 - next: 后置依赖
└ task_guid	string	依赖任务的GUID

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "dependencies": [
            {
                "type": "next",
                "task_guid": "93b7bd05-35e6-4371-b3c9-6b7cbd7100c0"
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1470400	请求参数有误，如依赖类型是非法的类型等。	具体错误原因参考返回的错误信息。
403	1470403	缺少任务的编辑权限	调用身份需要拥有添加依赖的任务和被添加为依赖的任务的编辑权限。
404	1470404	要添加依赖的任务不存在或已删除。	确认要添加依赖的任务和被添加为依赖的任务均存在或未被删除。
500	1470500	服务器错误。	服务器内部错误。服务器内部错误。若多次重试调用后持续出错可以联系支持。