Claude Platform Docs

Memory Versions

List memory versions
beta.memory_stores.memory_versions.list(memory_store_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsMemoryVersion]
GET/v1/memory_stores/{memory_store_id}/memory_versions
Retrieve a memory version
beta.memory_stores.memory_versions.retrieve(memory_version_id, **kwargs) -> BetaManagedAgentsMemoryVersion
GET/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}
Redact a memory version
beta.memory_stores.memory_versions.redact(memory_version_id, **kwargs) -> BetaManagedAgentsMemoryVersion
POST/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact
Models
type BetaManagedAgentsActor = ...

Identifies who performed an operation. Recorded when the operation happens and not updated afterwards, so the ID may refer to a user, service account, API key, or session that has since been deleted.

One of the following:
class BetaManagedAgentsAPIActor: type: "api_actor"; api_key_id

A direct caller of the public API, identified by the API key that authenticated the request.

type: Literal["api_actor"]
api_key_id: str

ID of the API key (an apikey_... value). This identifies the key, not the secret.

minLength1
class BetaManagedAgentsMemoryVersion: 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 BetaManagedAgentsMemoryVersionOperation = Literal["created", "modified", "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.

class BetaManagedAgentsServiceAccountActor: type: "service_account_actor"; service_account_id

A workload authenticated as a service account, for example via Workload Identity Federation.

type: Literal["service_account_actor"]
service_account_id: str

ID of the service account (a svac_... value).

minLength1
class BetaManagedAgentsSessionActor: type: "session_actor"; session_id

An agent acting during a session, for example through the session's mounted filesystem. It names the session itself, not the user or API key that started the session.

type: Literal["session_actor"]
session_id: str

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

minLength1
class BetaManagedAgentsUserActor: type: "user_actor"; user_id

A human user, for example acting through the Anthropic Console.

type: Literal["user_actor"]
user_id: str

ID of the user (a user_... value).

minLength1