删除 Memory

删除一条 memory。删除会产生一个 operation=deleted 的版本快照，历史版本内容仍然保留并可通过版本接口读取。如需物理移除某个版本已存储的内容字节，使用 Redact Memory 版本。

路径

DELETE /api/v1/forward/memory_stores/{memory_store_id}/memories/{memory_id}

请求头

头部	必选	说明
`Authorization`	是	`Bearer <PAT 或 admin SAT>`

路径参数

参数	类型	必选	说明
`memory_store_id`	string	是	Memory Store ID（`memstore_...`）。
`memory_id`	string	是	Memory ID（`mem_...`）。

示例请求

curl -X DELETE "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memories/mem_00mc7mvag5u68kkfvxhy" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK

{
  "id": "mem_00mc7mvag5u68kkfvxhy",
  "type": "memory_deleted",
  "deleted": true
}

响应字段解释

字段	类型	说明
`id`	string	被删除的 Memory ID。
`type`	string	固定为 `memory_deleted`。
`deleted`	boolean	是否已删除。

注意事项

删除后同一 path 可以重新创建新的 memory，新 memory 会有新的 mem_ ID。已归档的 Memory Store 不允许删除 memory，返回 409。

错误码

HTTP	type	触发条件
400	`invalid_request_error`	路径参数非法。
401	`authentication_error`	缺少或无效的认证令牌。
403	`permission_error`	当前调用方无权访问该资源。
404	`not_found_error`	Memory Store 或 Memory 不存在，或跨用户不可见。
409	`conflict_error`	Memory Store 已归档。
500/502/503	`api_error`	Forward 或依赖服务失败。

​路径

​请求头

​路径参数

​示例请求

​示例响应

​响应字段解释

​注意事项

​错误码

路径

请求头

路径参数

示例请求

示例响应

响应字段解释

注意事项

错误码