更新钉钉待办执行者状态

PUT

http://127.0.0.1/v1.0/todo/users/{unionId}/tasks/{taskId}/executorStatus

新版服务端API（DingTalk OpenAPI）/待办任务

最后修改时间：2022-08-30 09:19:21

责任人：未设置

说明

当待办存在多个执行者时，可调用本接口更新部分执行者的完成状态。
服务地址：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获取用户详情接口获取。

string

可选

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

isDone

boolean

执行者完成状态。

可选

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Body

result

boolean

更新结果。

可选

示例

{
    "result": true
}

更新钉钉待办任务

根据sourceId获取钉钉待办任务详情

更新钉钉待办执行者状态

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码