编辑 memory version

post /v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

编辑 memory version

Path Parameters

• memory_store_id: string

• memory_version_id: string

Header Parameters

• "anthropic-beta": optional array of AnthropicBeta

  可选的头部参数，用于指定您想使用的 beta 版本。

  • string

  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

    • "message-batches-2024-09-24"

    • "prompt-caching-2024-07-31"

    • "computer-use-2024-10-22"

    • "computer-use-2025-01-24"

    • "pdfs-2024-09-25"

    • "token-counting-2024-11-01"

    • "token-efficient-tools-2025-02-19"

    • "output-128k-2025-02-19"

    • "files-api-2025-04-14"

    • "mcp-client-2025-04-04"

    • "mcp-client-2025-11-20"

    • "dev-full-thinking-2025-05-14"

    • "interleaved-thinking-2025-05-14"

    • "code-execution-2025-05-22"

    • "extended-cache-ttl-2025-04-11"

    • "context-1m-2025-08-07"

    • "context-management-2025-06-27"

    • "model-context-window-exceeded-2025-08-26"

    • "skills-2025-10-02"

    • "fast-mode-2026-02-01"

    • "output-300k-2026-03-24"

    • "user-profiles-2026-03-24"

    • "advisor-tool-2026-03-01"

    • "managed-agents-2026-04-01"

    • "cache-diagnosis-2026-04-07"

Returns

• BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }

  一个 memory_version 对象：memory 追加式历史中的一行不可变、带归属的记录。每次对 memory 的非空操作都会产生一个新的 version。Version 属于 store（而非单个 memory），在 memory 删除后仍然存在。检索已编辑的 version 会返回 200，其中 content、path、content_size_bytes 和 content_sha256 设为 null；请根据 redacted_at 而非 HTTP 状态进行判断。

  • id: string

    此 version 的唯一标识符（memver_... 值）。

  • created_at: string

    RFC 3339 格式的时间戳

  • memory_id: string

    此 version 快照的 memory 的 ID（mem_... 值）。在 memory 删除后仍然有效；将其作为 memory_id 传入 列出 memory versions 以检索完整血统，包括 deleted 行。

  • memory_store_id: string

    此 version 所属的 memory store 的 ID（memstore_... 值）。

  • operation: BetaManagedAgentsMemoryVersionOperation

    memory_version 记录的变更类型。每次对 memory 的非空操作都会追加一个包含这些值之一的 version 行。

    • "created"

    • "modified"

    • "deleted"

  • type: "memory_version"

    • "memory_version"

  • content: optional string

    此版本时 memory 的 UTF-8 文本内容。当 view=basic、operation 为 deleted 或 redacted_at 已设置时为 null。

  • content_sha256: optional string

    此版本时 content 的小写十六进制 SHA-256 摘要（64 个字符）。当 redacted_at 已设置或 operation 为 deleted 时为 null。否则无论 view 如何设置，始终被填充。

  • content_size_bytes: optional number

    此版本时 content 的字节大小。当 redacted_at 已设置或 operation 为 deleted 时为 null。否则无论 view 如何设置，始终被填充。

  • created_by: optional BetaManagedAgentsActor

    标识谁执行了写入或编辑操作。在 memory_version 行的写入时捕获。创建 session 的 API 密钥不会记录在 agent 写入中；归属回答的是谁执行了写入，而非谁最终负责。请通过 Sessions API 单独查找 session 来源。

    • BetaManagedAgentsSessionActor object { session_id, type }

      agent 在 session 期间通过挂载的文件系统 /mnt/memory/ 执行写入的归属。

      • session_id: string

        执行写入的 session 的 ID（sesn_... 值）。通过 检索 session 查找 session 以获取更多信息。

      • type: "session_actor"

        • "session_actor"

    • BetaManagedAgentsAPIActor object { api_key_id, type }

      通过公共 API（在任何 session 之外）直接执行写入的归属。

      • api_key_id: string

        执行写入的 API 密钥的 ID。这标识的是密钥，而非密钥本身。

      • type: "api_actor"

        • "api_actor"

    • BetaManagedAgentsUserActor object { type, user_id }

      人类用户通过 Anthropic Console 执行写入的归属。

      • type: "user_actor"

        • "user_actor"

      • user_id: string

        执行写入的用户的 ID（user_... 值）。

  • path: optional string

    此次写入时 memory 的路径。当且仅当 redacted_at 已设置时为 null。

  • redacted_at: optional string

    RFC 3339 格式的时间戳

  • redacted_by: optional BetaManagedAgentsActor

    标识谁执行了写入或编辑操作。在 memory_version 行的写入时捕获。创建 session 的 API 密钥不会记录在 agent 写入中；归属回答的是谁执行了写入，而非谁最终负责。请通过 Sessions API 单独查找 session 来源。

Example

curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \
    -X POST \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "memory_id": "memory_id",
  "memory_store_id": "memory_store_id",
  "operation": "created",
  "type": "memory_version",
  "content": "content",
  "content_sha256": "content_sha256",
  "content_size_bytes": 0,
  "created_by": {
    "session_id": "x",
    "type": "session_actor"
  },
  "path": "path",
  "redacted_at": "2019-12-27T18:11:19.117Z",
  "redacted_by": {
    "session_id": "x",
    "type": "session_actor"
  }
}