DELETE /memory/{id}
删除单条记忆条目。
DELETE /cells/{cellID}/memory/{id}
认证
Authorization: Bearer $TOKEN
路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|
cellID | string | ✅ | Cell ID |
id | string | ✅ | 记忆条目 ID |
请求示例
curl -X DELETE "http://localhost:9091/cells/dept-legal/memory/mem-abc123" \
-H "Authorization: Bearer $TOKEN"
响应
成功(200 OK)
{
"success": true
}
无权限(403 Forbidden)
{
"error": "forbidden",
"message": "memory entry does not belong to you"
}
注意事项
- 删除是幂等的:条目不存在时也返回 200 成功。"要它没就是没了"。
- 不属于你返回 403,而非 404。点名要删一行配得上一句拒绝。
与 GET 的区别
GET /memory/{id} 与 DELETE /memory/{id} 对"不是你的"故意返回不同状态码:
| 操作 | 不存在 | 不属于你 | 设计理由 |
|---|
GET | 404 | 404 | 读取不配得到"它确实存在"的确认(防存在性泄漏) |
DELETE | 200(幂等) | 403 | 点名要删一行配得上一句拒绝(静默成功会被读作"已经删了") |
错误码
| HTTP | 错误 | 说明 |
|---|
| 403 | forbidden | 条目不属于当前 actor |
| 401 | — | Token 缺失或无效 |
相关端点