Updated on 2025-08-13 GMT+08:00

Deleting Dialog History in Batches

Function

This interface is used to delete historical dialog information in batches based on dialog IDs.

URI

DELETE /v1/koosearch/chat-history/batch

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Parameter description:

Token used for API authentication. For how to obtain the token, see section 3.2 "Authentication."

Constraints:

N/A.

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

chat_ids

Yes

Array of strings

ID list of chats to be deleted

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

total_count

Integer

Total number of chats to be deleted

deleted_count

Integer

Number of chats successfully deleted

Example Requests

DELETE https://{endpoint}/v1/koosearch/chat-history/batch

{
  "chat_ids" : [ "dae31d83-36f6-4972-ac50-6034e04c87a2", "be36c420-ee12-4e35-85d4-00aa9039091e" ]
}

Example Responses

Status code: 200

Deleted.

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

Status Codes

Status Code

Description

200

Deleted.

Error Codes

See Error Codes.