选择应用类型
第三方企业应用开发

删除文件(夹)

更新于 2024-01-11调用本接口删除文件(夹)。

重要

为提升接口的使用体验,提供更加规范的接口,钉钉针对钉盘产品进行了升级,目前已升级为存储产品。本接口文档已于2023年01月17日迁移至历史文档(不推荐)目录下,且本接口仅保持现有功能,不再新增支持其他能力。

  • 如果未使用本接口,推荐使用存储产品删除文件或文件夹接口。

  • 如果已使用本接口,建议您根据自身实际情况切换至推荐接口。

调用本接口,实现删除文件(夹),以删除文件为例,具体示例如下图所示。

权限

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

应用类型

是否支持

权限

API Explorer调试

企业内部应用

支持

重要

暂不支持新增申请。

第三方企业应用

支持

重要

暂不支持新增申请。

第三方个人应用

暂不支持

暂不支持

请求方法

Loading...

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

调用该接口的访问凭证。

Path参数

名称

类型

是否必填

描述

spaceId

String

钉盘空间ID。

fileId

String

文件ID。

Query参数

名称

类型

是否必填

描述

unionId

String

用户unionId。

deletePolicy

String

删除策略,取值:

  • toRecycle:删除到回收站

  • completely:彻底删除

返回参数

名称

类型

描述

success

Boolean

调用是否成功。

示例

请求示例

Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

返回示例

Loading...

错误码

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

未知错误

点击纠错