删除文件(夹)
更新于 2024-01-11调用本接口删除文件(夹)。
为提升接口的使用体验,提供更加规范的接口,钉钉针对钉盘产品进行了升级,目前已升级为存储产品。本接口文档已于2023年01月17日迁移至历史文档(不推荐)目录下,且本接口仅保持现有功能,不再新增支持其他能力。
如果未使用本接口,推荐使用存储产品删除文件或文件夹接口。
如果已使用本接口,建议您根据自身实际情况切换至推荐接口。
调用本接口,实现删除文件(夹),以删除文件为例,具体示例如下图所示。

权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
企业内部应用 | 支持 | 重要 暂不支持新增申请。 | — |
第三方企业应用 | 支持 | 重要 暂不支持新增申请。 | — |
第三方个人应用 | 暂不支持 | — | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Path参数
Query参数
返回参数
名称 | 类型 | 描述 |
success | Boolean | 调用是否成功。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
400 | param.error | Invalid Param | 参数错误 |
400 | request.overlimit | You have sent too many requests. | 请求过于频繁 |
400 | unsupported.operation | Does not support the operation | 暂不支持该操作 |
400 | no.priviledge | You are not authorized to perform this operation. | 你没有权限进行此操作 |
404 | object.not.exist | File does not exist or has been deleted. | 文件不存在或已删除 |
500 | unknown.error | Unknown Error | 未知错误 |