Skip to main content
Memory Stores

遮蔽记忆版本 (Redact)

永久遮蔽指定的记忆版本,使其内容不可访问。

路径参数

参数类型是否必需说明
memory_store_idstringMemory Store ID,带 memstore_ 前缀
version_idstring版本 ID,带 memver_ 前缀

请求头

Header是否必需说明
AuthorizationBearer $QODER_PAT
Content-Typeapplication/json

请求示例

curl -X POST "https://api.qoder.com.cn/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"
}

返回参数

字段类型说明
idstring唯一版本标识
typestring固定为 "memory_version"
store_idstring所属 Memory Store 的 ID
entry_idstring关联的记忆条目 ID
entry_pathstring关联的记忆条目路径
actionstring原始动作类型(保持不变)
sizeint64原始内容大小(保留)
content_sha256string原始内容哈希(保留)
redactedboolean遮蔽后为 true
redacted_atstring遮蔽时间(ISO 8601)
created_atstring版本创建时间(ISO 8601)

错误码

HTTP类型触发条件
401TOKEN_INVALID缺失或无效的鉴权 Token
404not_found_errorMemory Store 或版本不存在

说明

  • 遮蔽操作不可逆。遮蔽后该版本内容将永久不可访问。
  • 遮蔽后 redacted 变为 true,redacted_at 被设置。
  • 响应不再包含 content 字段。
  • size 和 content_sha256 仍会保留,用于审计追踪。
  • 无需请求体。
  • 常见使用场景包括移除敏感数据、满足数据合规要求。
完整错误信封见 错误码
遮蔽记忆版本 (Redact) - Qoder CN