Memory Versions
List memory versions
Retrieve a memory version
Redact a memory version
Models
BetaManagedAgentsActor = BetaManagedAgentsSessionActor or BetaManagedAgentsAPIActor or BetaManagedAgentsUserActor or BetaManagedAgentsServiceAccountActorIdentifies 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.
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.
BetaManagedAgentsAPIActor object{ type: "api_actor", api_key_id }Attribution for a write made directly via the public API (outside of any session).
Attribution for a write made directly via the public API (outside of any session).
api_key_id: stringID of the API key that performed the write. This identifies the key, not the secret.
ID of the API key that performed the write. This identifies the key, not the secret.
BetaManagedAgentsMemoryVersion 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.
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.
BetaManagedAgentsMemoryVersionOperation = "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.
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.
The memory was created. The first version in any memory's lineage.
The memory's content, path, or both were changed via update. Writes the agent makes through the filesystem mount also appear as modified.
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.
BetaManagedAgentsServiceAccountActor 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.
Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
service_account_id: stringID of the service account that performed the write (a svac_... value).
ID of the service account that performed the write (a svac_... value).
BetaManagedAgentsSessionActor object{ type: "session_actor", session_id }Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.
Attribution for a write made by an agent during a session, through the mounted filesystem at /mnt/memory/.
session_id: stringID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.
ID of the session that performed the write (a sesn_... value). Look up the session via Retrieve a session for further provenance.
BetaManagedAgentsUserActor object{ type: "user_actor", user_id }Attribution for a write made by a human user through the Anthropic Console.
Attribution for a write made by a human user through the Anthropic Console.
user_id: stringID of the user who performed the write (a user_... value).
ID of the user who performed the write (a user_... value).