--- title: Memory Versions url: https://platform.claude.com/docs/en/api/php/beta/memory_stores/memory_versions --- # Memory Versions ## List Memory Versions `$client->beta->memoryStores->memoryVersions->list(string memoryStoreID, ?string apiKeyID, ?\Datetime createdAtGte, ?\Datetime createdAtLte, ?int limit, ?string memoryID, ?ManagedAgentsMemoryVersionOperation operation, ?string page, ?string serviceAccountID, ?string sessionID, ?ManagedAgentsMemoryView view, ?list betas, ?string workspaceID): PageCursor` **GET** `/v1/memory_stores/{memory_store_id}/memory_versions` List Memory Versions ### Parameters - `memoryStoreID: string` (path parameter) The ID of the memory store whose version history to list (`memstore_...`). - `apiKeyID?: optional string` (query parameter) Return only versions written with the API key that has this ID. - `createdAtGte?: optional \Datetime` (query parameter) Return versions created at or after this time (inclusive). - `createdAtLte?: optional \Datetime` (query parameter) Return versions created at or before this time (inclusive). - `limit?: optional int` (query parameter) The maximum number of versions to return per page, from 1 to 100. Defaults to 20. With `view=full`, a page holds at most 20 versions. - `memoryID?: optional string` (query parameter) Return only versions of the memory with this ID (`mem_...`). The filter still works after the memory is deleted. While that memory's versions are retained, the results include the version whose `operation` is `deleted`. - `operation?: optional ManagedAgentsMemoryVersionOperation` (query parameter) Return only versions that record this kind of change. - `page?: optional string` (query parameter) The `next_page` value from a previous response, to get the next page. Omit it to get the first page. - `serviceAccountID?: optional string` (query parameter) Return only versions written by the service account with this ID (`svac_...`). - `sessionID?: optional string` (query parameter) Return only versions written by the session with this ID. - `view?: optional ManagedAgentsMemoryView` (query parameter) Whether a `memory` or `memory_version` in the response includes its `content`. Defaults to `full` on retrieve operations and to `basic` on list, create, and update operations. With `full`, list operations return at most 20 items per page. - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `agent-memory-2026-07-22` or `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) 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 - `class ManagedAgentsMemoryVersion` - `"memory_version" type` - `string id` Unique identifier for this version (a `memver_...` value). - `\Datetime createdAt` When this version was written, in RFC 3339 format. - `string memoryID` The ID of the memory that this version belongs to (`mem_...`). The ID stays valid after the memory is deleted. Pass it as `memory_id` to [List Memory Versions](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list?sdk_languages=php) to get the memory's retained versions, including its `deleted` version while the lineage is retained. - `string memoryStoreID` ID of the memory store this version belongs to (a `memstore_...` value). - `ManagedAgentsMemoryVersionOperation operation` The kind of mutation this version records: `created`, `modified`, or `deleted`. - `?string content` 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. - `?string contentSha256` 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. - `?int contentSizeBytes` Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. - `?ManagedAgentsActor createdBy` Who made this change to the memory, or `null` if the author wasn't recorded. Redacting the version doesn't change this field. A `session_actor` here is an agent that wrote through the store's mounted filesystem at `/mnt/memory/`. The version doesn't record the API key that created that session. So the author in `created_by` is who made the change, not who is ultimately responsible for it. You can [retrieve the session](https://platform.claude.com/docs/en/api/beta/sessions/retrieve?sdk_languages=php) to learn more about where the change came from. - `?string path` The memory's path at the time of this write. `null` if and only if `redacted_at` is set. - `?\Datetime redactedAt` When the version was redacted, in RFC 3339, or `null` if it hasn't been. When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`. See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=php#redact-a-version) to learn more about redaction. - `?ManagedAgentsActor redactedBy` Who redacted this version, or `null` if it has not been redacted. In practice always an `api_actor`, `user_actor`, or `service_account_actor` (agents do not have a redact capability). ### Example ```php beta->memoryStores->memoryVersions->list( 'memory_store_id', apiKeyID: 'api_key_id', createdAtGte: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'), createdAtLte: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'), limit: 0, memoryID: 'memory_id', operation: ManagedAgentsMemoryVersionOperation::CREATED, page: 'page', serviceAccountID: 'service_account_id', sessionID: 'session_id', view: ManagedAgentsMemoryView::BASIC, betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($page); ``` #### Response (200) ```json { "data": [ { "id": "memver_011CZkZBJq5dWxk9fVLNcPht", "created_at": "2026-03-15T10:00:00Z", "memory_id": "mem_011CZkZ9X2dpNyB6YbtxvB6e", "memory_store_id": "memstore_01Wf3kQ8tZxB2mVr7HcJ4aNd", "operation": "created", "type": "memory_version", "content": null, "content_sha256": "ba7936d94c84d948a2232088f78228f175df6a8353b2d5bc9228eee5794a0024", "content_size_bytes": 28, "created_by": { "session_id": "sesn_011CZkZAtmR3yMPDzynEDxu7", "type": "session_actor" }, "path": "/preferences/formatting.md", "redacted_at": null, "redacted_by": { "session_id": "x", "type": "session_actor" } } ], "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ``` ## Retrieve a Memory Version `$client->beta->memoryStores->memoryVersions->retrieve(string memoryVersionID, string memoryStoreID, ?ManagedAgentsMemoryView view, ?list betas, ?string workspaceID): ManagedAgentsMemoryVersion` **GET** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}` Retrieve a Memory Version ### Parameters - `memoryStoreID: string` (path parameter) The ID of the memory store that holds the version (`memstore_...`). - `memoryVersionID: string` (path parameter) The ID of the memory version to retrieve (`memver_...`). - `view?: optional ManagedAgentsMemoryView` (query parameter) Whether a `memory` or `memory_version` in the response includes its `content`. Defaults to `full` on retrieve operations and to `basic` on list, create, and update operations. With `full`, list operations return at most 20 items per page. - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `agent-memory-2026-07-22` or `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) 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 - `class ManagedAgentsMemoryVersion` - `"memory_version" type` - `string id` Unique identifier for this version (a `memver_...` value). - `\Datetime createdAt` When this version was written, in RFC 3339 format. - `string memoryID` The ID of the memory that this version belongs to (`mem_...`). The ID stays valid after the memory is deleted. Pass it as `memory_id` to [List Memory Versions](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list?sdk_languages=php) to get the memory's retained versions, including its `deleted` version while the lineage is retained. - `string memoryStoreID` ID of the memory store this version belongs to (a `memstore_...` value). - `ManagedAgentsMemoryVersionOperation operation` The kind of mutation this version records: `created`, `modified`, or `deleted`. - `?string content` 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. - `?string contentSha256` 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. - `?int contentSizeBytes` Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. - `?ManagedAgentsActor createdBy` Who made this change to the memory, or `null` if the author wasn't recorded. Redacting the version doesn't change this field. A `session_actor` here is an agent that wrote through the store's mounted filesystem at `/mnt/memory/`. The version doesn't record the API key that created that session. So the author in `created_by` is who made the change, not who is ultimately responsible for it. You can [retrieve the session](https://platform.claude.com/docs/en/api/beta/sessions/retrieve?sdk_languages=php) to learn more about where the change came from. - `?string path` The memory's path at the time of this write. `null` if and only if `redacted_at` is set. - `?\Datetime redactedAt` When the version was redacted, in RFC 3339, or `null` if it hasn't been. When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`. See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=php#redact-a-version) to learn more about redaction. - `?ManagedAgentsActor redactedBy` Who redacted this version, or `null` if it has not been redacted. In practice always an `api_actor`, `user_actor`, or `service_account_actor` (agents do not have a redact capability). ### Example ```php beta ->memoryStores ->memoryVersions ->retrieve( 'memory_version_id', memoryStoreID: 'memory_store_id', view: ManagedAgentsMemoryView::BASIC, betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($betaManagedAgentsMemoryVersion); ``` #### Response (200) ```json { "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" } } ``` ## Redact a Memory Version `$client->beta->memoryStores->memoryVersions->redact(string memoryVersionID, string memoryStoreID, ?list betas, ?string workspaceID): ManagedAgentsMemoryVersion` **POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact` Redact a Memory Version ### Parameters - `memoryStoreID: string` (path parameter) The ID of the memory store that holds the version (`memstore_...`). - `memoryVersionID: string` (path parameter) The ID of the memory version to redact (`memver_...`). - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `agent-memory-2026-07-22` or `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) 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 - `class ManagedAgentsMemoryVersion` - `"memory_version" type` - `string id` Unique identifier for this version (a `memver_...` value). - `\Datetime createdAt` When this version was written, in RFC 3339 format. - `string memoryID` The ID of the memory that this version belongs to (`mem_...`). The ID stays valid after the memory is deleted. Pass it as `memory_id` to [List Memory Versions](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list?sdk_languages=php) to get the memory's retained versions, including its `deleted` version while the lineage is retained. - `string memoryStoreID` ID of the memory store this version belongs to (a `memstore_...` value). - `ManagedAgentsMemoryVersionOperation operation` The kind of mutation this version records: `created`, `modified`, or `deleted`. - `?string content` 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. - `?string contentSha256` 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. - `?int contentSizeBytes` Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. - `?ManagedAgentsActor createdBy` Who made this change to the memory, or `null` if the author wasn't recorded. Redacting the version doesn't change this field. A `session_actor` here is an agent that wrote through the store's mounted filesystem at `/mnt/memory/`. The version doesn't record the API key that created that session. So the author in `created_by` is who made the change, not who is ultimately responsible for it. You can [retrieve the session](https://platform.claude.com/docs/en/api/beta/sessions/retrieve?sdk_languages=php) to learn more about where the change came from. - `?string path` The memory's path at the time of this write. `null` if and only if `redacted_at` is set. - `?\Datetime redactedAt` When the version was redacted, in RFC 3339, or `null` if it hasn't been. When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`. See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=php#redact-a-version) to learn more about redaction. - `?ManagedAgentsActor redactedBy` Who redacted this version, or `null` if it has not been redacted. In practice always an `api_actor`, `user_actor`, or `service_account_actor` (agents do not have a redact capability). ### Example ```php beta ->memoryStores ->memoryVersions ->redact( 'memory_version_id', memoryStoreID: 'memory_store_id', betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($betaManagedAgentsMemoryVersion); ``` #### Response (200) ```json { "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" } } ``` ## Domain types ### Beta Managed Agents Actor - `class ManagedAgentsActor` - `class ManagedAgentsSessionActor` - `"session_actor" type` - `string sessionID` ID of the session (a `sesn_...` value). Look up the session via [Retrieve a session](https://platform.claude.com/docs/en/api/beta/sessions/retrieve?sdk_languages=php) for further provenance. - `class ManagedAgentsAPIActor` - `"api_actor" type` - `string apiKeyID` ID of the API key (an `apikey_...` value). This identifies the key, not the secret. - `class ManagedAgentsUserActor` - `"user_actor" type` - `string userID` ID of the user (a `user_...` value). - `class ManagedAgentsServiceAccountActor` - `"service_account_actor" type` - `string serviceAccountID` ID of the service account (a `svac_...` value). ### Beta Managed Agents API Actor - `class ManagedAgentsAPIActor` - `"api_actor" type` - `string apiKeyID` ID of the API key (an `apikey_...` value). This identifies the key, not the secret. ### Beta Managed Agents Memory Version - `class ManagedAgentsMemoryVersion` - `"memory_version" type` - `string id` Unique identifier for this version (a `memver_...` value). - `\Datetime createdAt` When this version was written, in RFC 3339 format. - `string memoryID` The ID of the memory that this version belongs to (`mem_...`). The ID stays valid after the memory is deleted. Pass it as `memory_id` to [List Memory Versions](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list?sdk_languages=php) to get the memory's retained versions, including its `deleted` version while the lineage is retained. - `string memoryStoreID` ID of the memory store this version belongs to (a `memstore_...` value). - `ManagedAgentsMemoryVersionOperation operation` The kind of mutation this version records: `created`, `modified`, or `deleted`. - `?string content` 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. - `?string contentSha256` 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. - `?int contentSizeBytes` Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. - `?ManagedAgentsActor createdBy` Who made this change to the memory, or `null` if the author wasn't recorded. Redacting the version doesn't change this field. A `session_actor` here is an agent that wrote through the store's mounted filesystem at `/mnt/memory/`. The version doesn't record the API key that created that session. So the author in `created_by` is who made the change, not who is ultimately responsible for it. You can [retrieve the session](https://platform.claude.com/docs/en/api/beta/sessions/retrieve?sdk_languages=php) to learn more about where the change came from. - `?string path` The memory's path at the time of this write. `null` if and only if `redacted_at` is set. - `?\Datetime redactedAt` When the version was redacted, in RFC 3339, or `null` if it hasn't been. When set, `content`, `path`, `content_size_bytes`, and `content_sha256` are `null`. See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=php#redact-a-version) to learn more about redaction. - `?ManagedAgentsActor redactedBy` Who redacted this version, or `null` if it has not been redacted. In practice always an `api_actor`, `user_actor`, or `service_account_actor` (agents do not have a redact capability). ### Beta Managed Agents Memory Version Operation - `enum ManagedAgentsMemoryVersionOperation` - `"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. ### Beta Managed Agents Service Account Actor - `class ManagedAgentsServiceAccountActor` - `"service_account_actor" type` - `string serviceAccountID` ID of the service account (a `svac_...` value). ### Beta Managed Agents Session Actor - `class ManagedAgentsSessionActor` - `"session_actor" type` - `string sessionID` ID of the session (a `sesn_...` value). Look up the session via [Retrieve a session](https://platform.claude.com/docs/en/api/beta/sessions/retrieve?sdk_languages=php) for further provenance. ### Beta Managed Agents User Actor - `class ManagedAgentsUserActor` - `"user_actor" type` - `string userID` ID of the user (a `user_...` value).