from line 1
1---
2title: List memory versions
3url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list
4---
1# List memory versions
52
6## List memory versions
3**GET** `/v1/memory_stores/{memory_store_id}/memory_versions`
74
8**get** `/v1/memory_stores/{memory_store_id}/memory_versions`
9
105List memory versions
116
12### Path Parameters
7## Path parameters
138
149- `memory_store_id: string`
1510
16### Query Parameters
11## Query parameters
1712
1813- `api_key_id: optional string`
1914
from line 18
2318
2419 Return versions created at or after this time (inclusive).
2520
21 format: date-time
22
2623- `"created_at[lte]": optional string`
2724
2825 Return versions created at or before this time (inclusive).
2926
27 format: date-time
28
3029- `limit: optional number`
3130
3231 Query parameter for limit
3332
33 format: int32
34
3435- `memory_id: optional string`
3536
3637 Query parameter for memory_id
from line 66
6566
6667 - `"full"`
6768
68### Header Parameters
69## Headers
6970
7071- `"anthropic-beta": optional array of AnthropicBeta`
7172
from line 144
143144
144145 - `"mid-conversation-tool-changes-2026-07-01"`
145146
146### Returns
147## Returns
147148
148149- `data: optional array of BetaManagedAgentsMemoryVersion`
149150
from line 158
157158
158159 A timestamp in RFC 3339 format
159160
161 format: date-time
162
160163 - `memory_id: string`
161164
162165 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](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
from line 180
177180
178181 - `type: "memory_version"`
179182
180 - `"memory_version"`
181
182183 - `content: optional string or null`
183184
184185 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.
from line 192
191192
192193 Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
193194
195 format: int32
196
194197 - `created_by: optional BetaManagedAgentsActor`
195198
196199 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](/docs/en/api/sessions-retrieve).
197200
198 - `BetaManagedAgentsSessionActor object { session_id, type }`
201 - `BetaManagedAgentsSessionActor object`
199202
200203 Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
201204
from line 206
203206
204207 ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance.
205208
209 minLength: 1
210
206211 - `type: "session_actor"`
207212
208 - `"session_actor"`
213 - `BetaManagedAgentsAPIActor object`
209214
210 - `BetaManagedAgentsAPIActor object { api_key_id, type }`
211
212215 Attribution for a write made directly via the public API (outside of any session).
213216
214217 - `api_key_id: string`
from line 218
215218
216219 ID of the API key that performed the write. This identifies the key, not the secret.
217220
221 minLength: 1
222
218223 - `type: "api_actor"`
219224
220 - `"api_actor"`
225 - `BetaManagedAgentsUserActor object`
221226
222 - `BetaManagedAgentsUserActor object { type, user_id }`
223
224227 Attribution for a write made by a human user through the Anthropic Console.
225228
226229 - `type: "user_actor"`
227230
228 - `"user_actor"`
229
230231 - `user_id: string`
231232
232233 ID of the user who performed the write (a `user_...` value).
233234
234 - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }`
235 minLength: 1
235236
237 - `BetaManagedAgentsServiceAccountActor object`
238
236239 Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation.
237240
238241 - `service_account_id: string`
from line 242
239242
240243 ID of the service account that performed the write (a `svac_...` value).
241244
245 minLength: 1
246
242247 - `type: "service_account_actor"`
243248
244 - `"service_account_actor"`
245
246249 - `path: optional string or null`
247250
248251 The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
from line 254
251254
252255 A timestamp in RFC 3339 format
253256
257 format: date-time
258
254259 - `redacted_by: optional BetaManagedAgentsActor`
255260
256261 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](/docs/en/api/sessions-retrieve).
from line 264
259264
260265 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
261266
262### Example
267## Example
263268
264```http
269```bash
265270curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions \
266271 -H 'anthropic-version: 2023-06-01' \
267272 -H 'anthropic-beta: agent-memory-2026-07-22' \
from line 273
268273 -H "X-Api-Key: $ANTHROPIC_API_KEY"
269274```
270275
271#### Response
276### Response (200)
272277
273278```json
274279{
No line in this hunk matches that.