Skip to main content
Files

删除文件

删除一个 File。

DELETE /api/v1/cloud/files/{file_id} 删除 File 并返回删除确认。

路径参数

参数类型说明
file_idstringFile ID,前缀为 file_

请求头

头部必选说明
AuthorizationBearer <PAT 或 SAT>

示例请求

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

示例响应

HTTP 200 OK
{
  "id": "file_019e3bb8c1387743bf4ef115aae5acb1",
  "type": "file_deleted"
}
删除成功通过响应体中的 "type": "file_deleted" 标识。

错误码

HTTPtype触发条件
401authentication_error缺少或无效的认证令牌
404not_found_error文件不存在
409conflict_error文件仍被活跃资源引用
完整错误信封说明详见 错误参考

相关