按 id 批量删除原子记忆笔记

最近更新时间:2026-05-26 21:12:01

我的收藏

接口介绍

本接口(/atom/delete)用于按主键批量删除原子记忆。通过 ids 传入要删除的原子记忆主键列表,系统精确删除一组目标:
删除范围:通过 ids 传入主键数组(必填,非空),单次至多 100 条。
不支持条件批删:仅支持按 id 精确删除,不接受按 type / 时间区间等条件批量删除——原子记忆是经系统抽取后的细粒度沉淀产物,按条件批删容易牵连无关历史语义;可先通过 POST /atom/queryPOST /atom/search 获取目标 id 后再执行删除。
说明:
ids 为空数组视为非法请求,返回业务错误码 400,避免空入参导致整个租户全量数据被删。服务端执行删除前会独立比对归属字段,不属于当前调用上下文的 id 静默跳过,不计入 deleted_count

Method 与 URL

POST https://{服务访问地址}/v2/atom/delete

使用示例

curl -i -k -X POST \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer ******************************' \\
-H "x-tdai-service-id: mem-8i8t****" \\
https://memory.tdai.tencentyun.com/v2/atom/delete \\
-d '{
"ids": ["note-3a7b9c1d", "note-4e8d2f60", "note-5f9e3a71"]
}'
说明:
鉴权说明:所有接口都必须在请求头中携带 Authorization: Bearer <API Key>x-tdai-service-id: <Service_ID>,否则将返回鉴权失败。

请求参数

参数名
类型
必填
描述说明
ids
List[str]
原子记忆 ID 列表。需要进行批量处理的原子记忆唯一主键数组。
数量限制:单次请求最多支持传入 100 条 ID。
约束条件:传入的数组不能为空(不可传空数组 [])。

响应示例

{
"code": 0,
"message": "ok",
"request_id": "req-7fd3b2dd",
"data": {
"deleted_count": 5
}
}
字段名
类型
说明
deleted_count
int
实际成功删除的原子记忆条数。