删除文件¶

删除临时文件，删除后无法恢复。

POST https://api.moi.matrixorigin.cn/v5/connectors/file/delete

调用前准备¶

准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和临时文件 ID。删除前确认不再需要该文件。

请求体¶

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID 和 $CONN_FILE_ID 替换为实际值。

输入示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/connectors/file/delete" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d "{
    \"conn_file_id\": \"$CONN_FILE_ID\"
  }"

参数说明

参数	类型	是否必填	说明
`conn_file_id`	string	是	待删除的临时文件 ID。

成功响应¶

成功响应如下。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	null	不返回已删除文件的元数据。

错误响应¶

响应示例

{
  "code": "ErrParamInvalid",
  "msg": "invalid file identifier",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	可读错误信息。
`data`	null	错误响应中为 `null`。

后续操作¶

需要确认删除结果时，保留 conn_file_id 并再次预览文件或下载文件。临时文件已删除时，这两个接口返回不存在错误。

最后更新于 2026 年 9 月 11 日