删除历史对话
更新时间：2026-04-10
POST
https://qianfan.baidubce.com/v2/app/memory/conversations/delete
删除指定的历史对话记录，根据 conversation_id 删除对应的对话，返回操作结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
conversation_id
string
对话 ID，用于指定需要删除的历史对话记录。
必选
end_user_id
string
终端用户 ID，用于隔离不同用户的对话上下文和历史记录。需与创建该对话时传入的终端用户 ID 保持一致。
可选
请求结构
POST /v2/app/memory/conversations/delete HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"conversation_id": "b44fb587-ba3c-4b2e-9949-c8e23ca3ca79",
"end_user_id": "test001"
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/v2/app/memory/conversations/delete" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"conversation_id": "b44fb587-ba3c-4b2e-9949-c8e23ca3ca79",
"end_user_id": "test001"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
string
响应状态码，表示请求处理结果。
可选
message
string
响应信息，当请求失败时返回错误详情。
可选
request_id
string
请求 ID，用于唯一标识本次请求，便于问题排查。
可选
result
object {0}
返回结果对象，删除成功时返回空对象。
可选
显示子属性
隐藏子属性
暂无参数
成功示例
{
"code": "success",
"message": "",
"request_id": "be97d5a8-e2aa-4d8a-8f76-077cf37bf875",
"result": {}
}评价此篇文章