接口介绍
本接口(
/atom/delete)用于按主键批量删除原子记忆。通过 ids 传入要删除的原子记忆主键列表,系统精确删除一组目标:删除范围:通过
ids 传入主键数组(必填,非空),单次至多 100 条。不支持条件批删:仅支持按
id 精确删除,不接受按 type / 时间区间等条件批量删除——原子记忆是经系统抽取后的细粒度沉淀产物,按条件批删容易牵连无关历史语义;可先通过 POST /atom/query 或 POST /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 | 实际成功删除的原子记忆条数。 |