文档首页/云搜索服务 CSS_企业搜索服务 KooSearch/API参考/API/API/对话历史/批量删除对话历史 - BatchDeleteChatHistory
更新时间：2026-03-18 GMT+08:00
查看PDF
分享

批量删除对话历史 - BatchDeleteChatHistory

功能介绍

根据对话ID，批量删除对话历史信息。

URI

DELETE /v1/{project_id}/applications/{application_id}/uni-search/chat-history/batch

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，获取方法请参见获取项目ID。

约束限制：

不涉及

取值范围：

1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。

默认取值：

不涉及

application_id

是

String

参数解释：

应用ID，获取方法请参见获取应用ID。

约束限制：

字符串

取值范围：

1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

接口鉴权使用的Token，Token获取方式参考：获取IAM用户Token。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

chat_ids

是

Array of strings

参数解释：

待删除的会话ID列表。

约束限制：

不涉及

取值范围：

会话ID，必须为1-64位的字母、数字、下划线或短横线。

默认取值：

不涉及

repo_ids

否

Array of strings

参数解释： 待删除的对话历史对应的知识库id列表。 约束限制： 不涉及 取值范围： id是1-64个字符，长度最大100。 默认取值： 不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total_count

Integer

参数解释：

需要删除对话历史的总数。

取值范围：

不涉及

deleted_count

Integer

参数解释：

成功删除的对话历史数量。

取值范围：

不涉及

请求示例

批量删除对话历史。

/v1/b25446daeb1a41a7953c5deba2b2677a/applications/be9b19bf-4865-4fb8-b9f8-2fd1fea98d76/uni-search/chat-history/batch

{
  "chat_ids" : [ "a51ce4e0-66b4-446c-8376-13deba725da5", "06611077-453e-4fd0-83f9-b635d8c84bc2" ],
  "repo_ids" : [ "7741920e-7c1c-4a48-8555-c43b66153272", "7741920e-7c1c-4a48-8555-c43b66153272" ]
}

响应示例

状态码：200

批量删除对话历史响应。

{
  "totalCount" : 2,
  "deletedCount" : 2
}

状态码

状态码

描述

200

批量删除对话历史响应。

错误码

请参见错误码。

父主题：对话历史