# 批量删除对话历史
#### 功能介绍
根据对话ID，批量删除对话历史信息。
#### URI
DELETE /v1/koosearch/chat-history/batch
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                           |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 接口鉴权使用的Token，Token获取方式参考：3.2节 认证鉴权。 **约束限制：** 不涉及。 |
   
表2请求Body参数 
| 参数       | 是否必选 | 参数类型             | 描述          |
|:---|:---|:---|:---|
| chat_ids | 是    | Array of strings | 待删除的会话ID列表。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数            | 参数类型    | 描述          |
|:---|:---|:---|
| total_count   | Integer | 需要删除对话历史的总数 |
| deleted_count | Integer | 成功删除的对话历史数量 |
   
#### 请求示例
```
DELETE https://{endpoint}/v1/koosearch/chat-history/batch
{
  "chat_ids" : [ "dae31d83-36f6-4972-ac50-6034e04c87a2", "be36c420-ee12-4e35-85d4-00aa9039091e" ]
}
```
#### 响应示例
**状态码：200**
删除成功。
```
{
  "totalCount" : 2,
  "deletedCount" : 2
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 删除成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。