删除钉钉待办任务
DELETE
/v1.0/todo/users/{unionId}/tasks/{taskId}最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口删除钉钉待办任务信息,ISV在自身应用待办数据被删除后,需调用该接口将钉钉侧待办数据同步删除。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 待办应用中待办写权限 | API Explorer |
第三方企业应用 | 支持 | 待办应用中待办写权限 | API Explorer |
第三方个人应用 | 暂不支持 | 待办应用中待办写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | todo.taskDelete.paramError | todo.taskDelete.paramError | 删除待办参数异常 |
500 | todo.taskDelete.systemError | todo.taskDelete.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
object {0}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
删除结果。
requestId
string
请求ID。
示例
{
"result": true,
"requestId": "string"
}
最后修改时间: 2 年前