Copy

永久移除某个版本已存储的内容字节，版本元数据保留用于审计。用于合规场景 —— 例如某条记忆里误存了敏感信息，需要在存储层彻底抹除而不是逻辑删除。 该操作不可逆：内容字节被物理删除，无法恢复。与删除 Memory 的区别是后者只做逻辑删除、历史版本内容仍然保留。

路径

POST /api/v1/forward/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

请求头

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

不需要请求体，传入的请求体会被忽略。

路径参数

参数	类型	必选	说明
`memory_store_id`	string	是	Memory Store ID（`memstore_...`）。
`memory_version_id`	string	是	要脱敏的版本 ID（`memver_...`）。

示例请求

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memory_versions/memver_00mc7mw0t337kbcx5q52/redact" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK

{
  "id": "memver_00mc7mw0t337kbcx5q52",
  "type": "memory_version",
  "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
  "memory_id": "mem_00mc7mvag5u68kkfvxhy",
  "path": "decisions/arch-choice.md",
  "content": null,
  "content_size_bytes": 108,
  "content_sha256": "9a4f8d2c1b7e6543210fedcba9876543210fedcba9876543210fedcba987654",
  "operation": "updated",
  "redacted": true,
  "redacted_at": "2026-08-14T12:00:00Z",
  "created_at": "2026-08-14T11:00:00Z"
}

响应字段解释

返回脱敏后的 Memory Version 对象，content 变为 null，redacted 变为 true，redacted_at 被填充。

注意事项

只影响指定的这一个版本。同一 memory 的其他版本、当前内容和 metadata 都不受影响。
已归档的 Memory Store 不阻塞该操作 —— 归档禁止创建、更新、删除 memory，但脱敏作为合规动作始终可执行。
对同一版本重复调用返回 409。

错误码

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

​路径

​请求头

​路径参数

​示例请求

​示例响应

​响应字段解释

​注意事项

​错误码

路径

请求头

路径参数

示例请求

示例响应

响应字段解释

注意事项

错误码