千问办公企业旗舰版开发者文档:删除文件或目录。
认证方式见APP开发者文档 → 认证接入。
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
path 使用 query 编码的绝对逻辑路径;修改/删除不改变当前用户的资源归属。
按 ID 定位后,文件或父目录重命名不改变该 ID。删除后同路径重建会得到新 ID。
204 无响应体。
401 表示认证失败,403 表示资源权限拒绝;400/422 表示参数无效,404 表示当前用户资源不存在,409 表示冲突。依赖故障保持原错误,不伪造成功;503 为维护或依赖不可用,504 为请求超时。写操作结果未知时先查询资源状态,不盲目重复执行。
- 模块:文件
- 接口:DELETE
/api/openapi/app/v1/drive/files - operationId:
app-delete-files
接口说明
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
path 使用 query 编码的绝对逻辑路径;修改/删除不改变当前用户的资源归属。
按 ID 定位后,文件或父目录重命名不改变该 ID。删除后同路径重建会得到新 ID。
请求参数
| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| path | query | string | 二选一 | 当前用户绝对逻辑路径,使用 query 编码 |
| file_id | query | string (uuid) | 二选一 | 单个非零 UUID,与 path 不能同时传;其他用户 ID 返回 404 |
| recursive | query | string | 否 | 仅字符串 true 启用递归删除;省略或其他值不启用。 |