Claude Platform Docs

Redact a memory version

$ ant beta:memory-stores:memory-versions redact
POST/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

Redact a memory version

Parameters
--memory-store-id: string

Path param: The ID of the memory store that holds the version (memstore_...).

--memory-version-id: string

Path param: The ID of the memory version to redact (memver_...).

--beta: optional array of AnthropicBeta

Header param: Optional header to specify the beta version(s) you want to use.

--workspace-id: optional string

Header param: Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns
beta_managed_agents_memory_version: object{ type: "memory_version", id, created_at, 10 more }

A memory_version object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with content, path, content_size_bytes, and content_sha256 set to null; branch on redacted_at, not HTTP status.

type: "memory_version"
id: string

Unique identifier for this version (a memver_... value).

created_at: string

A timestamp in RFC 3339 format

formatdate-time
memory_id: string

ID of the memory this version snapshots (a mem_... value). Remains valid after the memory is deleted; pass it as memory_id to List memory versions to retrieve the memory's retained versions, including the deleted row while the lineage is retained.

memory_store_id: string

ID of the memory store this version belongs to (a memstore_... value).

operation: "created" or "modified" or "deleted"

The kind of mutation a memory_version records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.

One of the following:
"created"

The memory was created. The first version in any memory's lineage.

"modified"

The memory's content, path, or both were changed via update. Writes the agent makes through the filesystem mount also appear as modified.

"deleted"

The memory was deleted. The content, content_size_bytes, and content_sha256 fields are null on this version. The preceding version, while it is retained, records the deleted content's size and hash.

content: optional string

The memory's UTF-8 text content as of this version. null when view=basic, when operation is deleted, or when redacted_at is set.

content_sha256: optional string

Lowercase hex SHA-256 digest of content as of this version (64 characters). null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

content_size_bytes: optional number

Size of content in bytes as of this version. null when redacted_at is set or operation is deleted. Populated regardless of view otherwise.

formatint32
created_by: optional BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor or BetaManagedAgentsServiceAccountActor

Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

One of the following:
beta_managed_agents_session_actor: object{ type: "session_actor", session_id }

Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.

type: "session_actor"
session_id: string

ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.

minLength1
beta_managed_agents_api_actor: object{ type: "api_actor", api_key_id }

Attribution for a write made directly via the public API (outside of any session).

type: "api_actor"
api_key_id: string

ID of the API key that performed the write. This identifies the key, not the secret.

minLength1
beta_managed_agents_user_actor: object{ type: "user_actor", user_id }

Attribution for a write made by a human user through the Anthropic Console.

type: "user_actor"
user_id: string

ID of the user who performed the write (a user_... value).

minLength1
beta_managed_agents_service_account_actor: object{ type: "service_account_actor", service_account_id }

Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.

type: "service_account_actor"
service_account_id: string

ID of the service account that performed the write (a svac_... value).

minLength1
path: optional string

The memory's path at the time of this write. null if and only if redacted_at is set.

redacted_at: optional string

A timestamp in RFC 3339 format

formatdate-time
redacted_by: optional BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor or BetaManagedAgentsServiceAccountActor

Identifies who performed a write or redact operation. Captured at write time on the memory_version row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the Sessions API.

One of the following:
beta_managed_agents_session_actor: object{ type: "session_actor", session_id }

Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.

type: "session_actor"
session_id: string

ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.

minLength1
beta_managed_agents_api_actor: object{ type: "api_actor", api_key_id }

Attribution for a write made directly via the public API (outside of any session).

type: "api_actor"
api_key_id: string

ID of the API key that performed the write. This identifies the key, not the secret.

minLength1
beta_managed_agents_user_actor: object{ type: "user_actor", user_id }

Attribution for a write made by a human user through the Anthropic Console.

type: "user_actor"
user_id: string

ID of the user who performed the write (a user_... value).

minLength1
beta_managed_agents_service_account_actor: object{ type: "service_account_actor", service_account_id }

Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.

type: "service_account_actor"
service_account_id: string

ID of the service account that performed the write (a svac_... value).

minLength1
Redact a memory version
ant beta:memory-stores:memory-versions redact \
  --api-key my-anthropic-api-key \
  --memory-store-id memory_store_id \
  --memory-version-id memory_version_id
Returns Examples
Response 200
{
  "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"
  }
}