新增执行者
POST
/task/v1/tasks/{task_id}/collaborators
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 401 | 1470403 | The identity token is incorrect. It should be either user_access_token or tenant_access_token. | 发起请求方的身份token不正确，需要为UserAccessToken或TenantAccessToken其中一种 |
| 400 | 1470404 | be refused to create or update task, perhaps you have no permission | 一般是因为操作者没有操作权限，导致更新任务或其他更新任务的操作失败。如，任务的关注者没有权限修改任务。 |
| 400 | 1470429 | The total number of collaborators exceeds the maximum number limit. | 执行者总数超过了最大数量限制，目前一个任务最多只能添加50人 |
| 400 | 1470431 | Users are all collaborators of tasks. | 用户已经是任务的协作者，不能重复添加 |
| 429 | 1470450 | request too fast | 当前同时发起的请求过多，峰值较高导致了限流，请稍后重新尝试 |
| 400 | 1470451 | Operation requests for the same task are too frequent. | 对同一个任务的操作请求太频繁，需要降低请求频次 |
| 400 | 1470602 | Invalid task id. | 请检查任务的 id 是否合 法 |
| 500 | 1470701 | Failed to add task collaborator. | 添加任务执行者失败，若重试无法解决，请联系飞书技术人员协助排查 |
请求参数
Path 参数
Query 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/task/v1/tasks/83912691-2e43-47fc-94a4-d512e03984fa/collaborators?user_id_type=open_id' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": "ou_99e1a581b36ecc4862cbfbce473f1234",
"id_list": [
"ou_550cc75233d8b7b9fcbdad65f34433f4"
]
}'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"collaborator": {
"id": "ou_99e1a581b36ecc4862cbfbce473f1234",
"id_list": [
"ou_550cc75233d8b7b9fcbdad65f34433f4"
]
}
}
}
扫码加入交流群修改于 2025-10-21 07:38:58