DELETE /v1/files/{file_id}
根据文件 ID 永久删除一个文件。删除操作不可逆。
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
file_id | string | 是 | 文件唯一标识(file_ 前缀) |
示例请求
示例响应
HTTP 204 No Content 删除成功时返回 HTTP 204,无响应体。错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 401 | authentication_error | 缺少或无效的认证令牌 |
| 404 | not_found_error | 指定 ID 的文件不存在 |
注意事项
- 删除操作是永久性的,无法恢复
- 删除后,通过列表接口将不再返回该文件
- 如果文件正在被某个会话引用,删除后会话中对该文件的引用将失效