更新钉钉待办任务
PUT
/v1.0/todo/users/{unionId}/tasks/{taskId}最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口接口更新钉钉待办任务信息及状态,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获取用户详情接口获取。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
更新结果。
示例
{
"result": true
}
最后修改时间: 2 年前