更新钉钉待办执行者状态
PUT
/v1.0/todo/users/{unionId}/tasks/{taskId}/executorStatus最后修改时间:: 2 年前
责任人: 未设置
说明
当待办存在多个执行者时,可调用本接口更新部分执行者的完成状态。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 待办应用中待办写权限,待办应用中待办读权限 | API Explorer |
第三方企业应用 | 支持 | 待办应用中待办写权限,待办应用中待办读权限 | API Explorer |
第三方个人应用 | 暂不支持 | 待办应用中待办写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | todo.taskExecutorStatusUpdate.paramError | todo.taskExecutorStatusUpdate.paramError | 更新待办执行者状态参数异常 |
500 | todo.taskExecutorStatusUpdate.systemError | todo.taskExecutorStatusUpdate.systemError | 更新待办执行者状态系统异常 |
请求参数
Path 参数
unionId
string
必需
当前访问的资源所归属用户的unionId,可通过根据userid获取用户详情接口获取。
taskId
string
待办ID。
Query 参数
operatorId
string
可选
当前操作者的用户的unionId,可通过根据userid获取用户详情接口获取。
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
executorStatusList
array [object {2}]
可选
执行者状态列表,id需传用户的unionId,可通过根据userid获取用户详情接口获取。
id
string
可选
执行者的unionId,可通过根据userid获取用户详情接口获取。
isDone
boolean
执行者完成状态。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
更新结果。
示例
{
"result": true
}
最后修改时间: 2 年前