全部产品
Search
文档中心

Qoder CN 系列:删除文件

更新时间:Jul 14, 2026

删除一个 File。

DELETE /api/v1/cloud/files/{file_id}

删除 File 并返回删除确认。

路径参数

参数

类型

说明

file_id

string

File ID,前缀为 file_

请求头

头部

必选

说明

Authorization

Bearer <PAT>

示例请求

curl -X DELETE https://api.qoder.com.cn/api/v1/cloud/files/file_019e3bb8c1387743bf4ef115aae5acb1 \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK

{
  "id": "file_019e3bb8c1387743bf4ef115aae5acb1",
  "type": "file_deleted"
}

删除成功通过响应体中的 "type": "file_deleted" 标识。

错误码

HTTP

type

触发条件

401

authentication_error

缺少或无效的认证令牌

404

not_found_error

文件不存在

409

conflict_error

文件仍被活跃资源引用

完整错误信封说明详见 错误参考