跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

DELETE /v1/files/{file_id} 根据文件 ID 永久删除一个文件。删除操作不可逆。

请求头

头部必选说明
AuthorizationBearer <PAT>

路径参数

参数类型必选说明
file_idstring文件唯一标识(file_ 前缀)

示例请求

curl -X DELETE "https://openapi.qoder.sh/api/v1/cloud/files/file_019e3bb8e4b67b7789e49ca6ecb2aae0" \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 204 No Content 删除成功时返回 HTTP 204,无响应体。

错误码

HTTPtype触发条件
401authentication_error缺少或无效的认证令牌
404not_found_error指定 ID 的文件不存在
错误响应示例:
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "File 'file_nonexistent123' was not found."
  }
}

注意事项

  • 删除操作是永久性的,无法恢复
  • 删除后,通过列表接口将不再返回该文件
  • 如果文件正在被某个会话引用,删除后会话中对该文件的引用将失效
完整错误信封说明详见 错误参考