更新钉钉待办任务

PUT

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

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

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

责任人：未设置

说明

调用本接口接口更新钉钉待办任务信息及状态，ISV在自身应用待办数据被更新后，需调用该接口将钉钉侧待办数据同步更新。
服务地址：api.dingtalk.com

权限

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

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

错误码

HttpCode	错误码	错误信息	说明
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.	client token不合法。
404	todo.task.notExisted	todo.task.notExisted	待办不存在
500	todo.taskUpdate.systemError	todo.taskUpdate.systemError	更新待办系统异常

请求参数

Path 参数

unionId

string

必需

当前访问资源所归属用户的unionId，和操作者的unionId保持一致，可通过根据userid获取用户详情接口获取。

taskId

string

待办ID。

必需

Query 参数

operatorId

string

可选

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

Header 参数

x-acs-dingtalk-access-token

string

必需

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

Body 参数application/json

subject

string

待办标题。

可选

description

string

待办描述。

可选

dueTime

integer

可选

截止时间，Unix时间戳，单位毫秒。

done

boolean

完成状态。

可选

executorIds

array[string]

可选

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

participantIds

array[string]

可选

参与者的unionId列表，可通过根据userid获取用户详情接口获取。

示例

{}

示例代码

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/' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

result

boolean

更新结果。

可选

示例

{
    "result": true
}

删除钉钉待办任务

更新钉钉待办执行者状态

更新钉钉待办任务

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码