Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
POST /v1/memory_stores/{memory_store_id}/versions/{version_id}/redact
遮蔽（Redact）指定版本的内容。遮蔽后该版本的内容将永久不可访问。
请求头
| 头部 | 必选 | 说明 |
|---|
Authorization | 是 | Bearer <PAT> |
Content-Type | 是 | application/json |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|
memory_store_id | string | 是 | Memory Store ID（memstore_ 前缀） |
version_id | string | 是 | 版本 ID（memver_ 前缀） |
示例请求
curl -X POST "https://openapi.qoder.sh/api/v1/cloud/memory_stores/memstore_xxx/versions/memver_xxx/redact" \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json"
示例响应
HTTP 200 OK
返回更新后的 MemoryVersion 对象（不含 content）。
{
"id": "memver_019e3bb9cf417d89970ba7f45e728c56",
"type": "memory_version",
"store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
"entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
"entry_path": "versions/test.md",
"action": "created",
"size": 17,
"content_sha256": "fe80a065cb120813abf7dfceb4018a53d6eb7140c785181634e019656176c64e",
"redacted": true,
"redacted_at": "2026-05-18T15:35:13.100297Z",
"created_at": "2026-05-18T15:34:53.528628Z"
}
响应字段
| 字段 | 类型 | 说明 |
|---|
id | string | 版本唯一标识符 |
type | string | 固定值 "memory_version" |
store_id | string | 所属 Store ID |
entry_id | string | 关联的记忆条目 ID |
entry_path | string | 关联记忆条目的路径 |
action | string | 原始操作类型（不变） |
size | int64 | 原始内容大小（保留） |
content_sha256 | string | 原始内容哈希（保留） |
redacted | boolean | 遮蔽后为 true |
redacted_at | string | 遮蔽执行时间（ISO 8601） |
created_at | string | 版本创建时间（ISO 8601） |
错误码
| HTTP | type | 触发条件 |
|---|
| 401 | authentication_error | 未提供或无效的认证令牌 |
| 404 | not_found_error | 指定的 Memory Store 或版本不存在 |
注意事项
- 遮蔽操作不可逆，执行后该版本的内容永久不可访问
- 遮蔽后
redacted 变为 true，并设置 redacted_at 时间戳
- 响应中不再包含
content 字段
size 和 content_sha256 保留原值（用于审计追踪）- 不需要请求体
- 适用场景：清除敏感数据、满足数据合规要求
完整错误信封说明详见 错误参考。
