帮你快速理解、总结文档立即下载

批量删除原始对话消息

最近更新时间:2026-07-28 10:20:01

我的收藏

接口介绍

本接口(/v3/conversation/delete)用于按消息 ID 批量删除 L0 原始对话消息。功能说明如下:
删除方式:支持按 message_ids 精确删除(单次 1–100 条),也可按 session_id 删除某会话下的全部消息,二者至少提供一项。不管按哪种方式删除,都需携带 session_id 参数(若未显式传入则使用该实例下与 message 绑定的 session_id)。
不可逆:删除为不可逆操作,被删除的消息将从 L0 存储中移除。

Method 与 URL

POST https://memory.tdai.tencentyun.com/v3/conversation/delete

使用示例

curl -i -k -X POST \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer *********************************' \\
-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\
https://memory.tdai.tencentyun.com/v3/conversation/delete \\
-d '{
"message_ids":["msg-aaaa","msg-bbbb","msg-cccc"]
}'
说明:
所有接口都必须在请求头中携带 Authorization: Bearer <API Key>x-tdai-service-id: <实例 ID>,否则将返回鉴权失败。

请求参数

参数
是否必选
参数含义
配置方法及要求
message_ids
待删除的消息 ID 列表。
数据类型:Array of String。
数量限制:单次最少 1 条,最多支持 100 条。

响应示例

{
"code":0,
"message":"ok",
"request_id":"req-7fd3b2dd",
"data":{
"deleted_count":3
}
}

响应参数说明

参数名(一级)
参数名(二级)
参数含义
data
deleted_count
成功删除的消息数量。