Claude Platform Docs

Memory Versions

List memory versions
MemoryVersionListPage beta().memoryStores().memoryVersions().list(MemoryVersionListParamsparams = MemoryVersionListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/memory_stores/{memory_store_id}/memory_versions
Retrieve a memory version
BetaManagedAgentsMemoryVersion beta().memoryStores().memoryVersions().retrieve(MemoryVersionRetrieveParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}
Redact a memory version
BetaManagedAgentsMemoryVersion beta().memoryStores().memoryVersions().redact(MemoryVersionRedactParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
POST/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact
Models
class BetaManagedAgentsActor: A class that can be one of several variants.union

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.

class BetaManagedAgentsSessionActor:

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

String sessionId

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

minLength1
Type type
class BetaManagedAgentsApiActor:

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

String apiKeyId

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

minLength1
Type type
class BetaManagedAgentsUserActor:

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

Type type
String userId

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

minLength1
class BetaManagedAgentsServiceAccountActor:

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

String serviceAccountId

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

minLength1
JsonValue type "service_account_actor"constant
class BetaManagedAgentsApiActor:

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

String apiKeyId

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

minLength1
Type type
class BetaManagedAgentsMemoryVersion:

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.

enum BetaManagedAgentsMemoryVersionOperation:

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.

CREATED("created")
MODIFIED("modified")
DELETED("deleted")
class BetaManagedAgentsServiceAccountActor:

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

String serviceAccountId

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

minLength1
JsonValue type "service_account_actor"constant
class BetaManagedAgentsSessionActor:

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

String sessionId

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

minLength1
Type type
class BetaManagedAgentsUserActor:

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

Type type
String userId

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

minLength1