更新钉钉待办执行者状态

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，当待办存在多个执行者时，可更新部分执行者的完成状态。

调用本接口，实现多个待办任务执行者的完成状态，具体示例如下图所示。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	待办应用中待办写权限,待办应用中待办读权限	API Explorer
第三方企业应用	支持	待办应用中待办写权限,待办应用中待办读权限	API Explorer
第三方个人应用	暂不支持	待办应用中待办写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	todo.taskExecutorStatusUpdate.paramError	todo.taskExecutorStatusUpdate.paramError	更新待办执行者状态参数异常
400	todo.taskExecutorStatusUpdate.paramError	task not exist	待办任务不存在
400	todo.taskExecutorStatusUpdate.paramError	task not belong to bizTag	待办任务不属于该应用
400	todo.taskExecutorStatusUpdate.paramError	executors is oversize	待办执行人超出限制
500	todo.taskExecutorStatusUpdate.systemError	todo.taskExecutorStatusUpdate.systemError	更新待办执行者状态系统异常

curl --location --request PUT 'https://api.dingtalk.com/v1.0/todo/users//tasks//executorStatus?operatorId' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '{}'

请求参数

Path 参数

unionId

必需

当前访问的资源所归属用户的unionId，可通过根据userid获取用户详情接口获取。

taskId

待办ID。

必需

Query 参数

operatorId

可选

当前操作者的用户的unionId，可通过根据userid获取用户详情接口获取。

Header 参数

x-acs-dingtalk-access-token

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

executorStatusList

array [object {2}]

可选

执行者状态列表，id需传用户的unionId，可通过根据userid获取用户详情接口获取。

string

可选

执行者的unionId，可通过根据userid获取用户详情接口获取。

isDone

boolean

执行者完成状态。

可选

示例

更新钉钉待办执行者状态

权限#

错误码#

请求参数

返回响应

权限

错误码