List Memories changedapi/beta/memory_stores/memories/list
Nearest release: v2.1.306, published 2 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+40added
Lines−16removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits20to this page, all time
# List Memories # List memories
The whole hunk
from line 1, old and new numbered
/
from line 1
11---
2title: List memories
2title: List Memories
33url: https://platform.claude.com/docs/en/api/beta/memory_stores/memories/list
44---
55
6# List memories
6# List Memories
77
88**GET** `/v1/memory_stores/{memory_store_id}/memories`
99
10List memories
10List Memories
1111
1212## Path parameters
1313
from line 19
1919
2020- `depth: optional number`
2121
22 `0` (or omitted) returns all descendants below `path_prefix` (recursive). `1` returns immediate children only; deeper entries roll up as `memory_prefix` items. `depth=1` behaves like `ls`; omitting `depth` behaves like `find`.
22 How far below `path_prefix` to list. Defaults to `0`, which lists every memory below the prefix.
2323
24 Pass `1` to list only the direct children. Deeper memories are then grouped into `memory_prefix` items.
25
2426 format: int32
2527
2628- `limit: optional number`
2729
28 Maximum number of items to return per page. Must be between 1 and 100. Defaults to 20 when omitted. Capped at 20 when `view=full`. Both `memory` and `memory_prefix` items count toward the limit.
30 The maximum number of items to return per page, from 1 to 100. Defaults to 20.
2931
32 With `view=full`, a page holds at most 20 items. `memory` and `memory_prefix` items both count toward the limit.
33
3034 format: int32
3135
3236- `page: optional string`
3337
34 Opaque pagination cursor (a `page_...` value). Pass the `next_page` value from a previous response to fetch the next page; omit for the first page.
38 The `next_page` value from a previous response, to get the next page. Omit it to get the first page.
3539
3640- `path_prefix: optional string`
3741
38 Optional path prefix filter. Must end with `/` (segment-aligned), e.g., `/notes/`. This value appears in request URLs. Do not include secrets or personally identifiable information.
42 Return only memories whose path starts with this prefix, such as `/notes/`. This value appears in request URLs. Do not include secrets or personally identifiable information.
3943
44 Omit it to list the whole store. The prefix must end with `/` and matches whole segments, so `/notes/` matches `/notes/todo.md` but not `/notes-archive/todo.md`.
45
4046- `view: optional BetaManagedAgentsMemoryView`
4147
42 Which projection of each `memory` to return. Defaults to `basic` (content omitted). `full` populates `content` on each item and caps `limit` at 20; use this as the bulk-read path for export and sync.
48 Whether each memory in the response includes `content`. Defaults to `basic`, which sets it to `null`.
4349
50 With `full`, a page holds at most 20 items.
51
4452 - `"basic"`
4553
4654 Return the object with `content` set to `null`. The `content_size_bytes` and `content_sha256` fields remain populated, so sync clients can diff without fetching content.
from line 187
179187
180188 - `BetaManagedAgentsMemory object`
181189
182 A `memory` object: a single text document at a hierarchical path inside a memory store. The `content` field is populated when `view=full` and `null` when `view=basic`; the `content_size_bytes` and `content_sha256` fields are always populated so sync clients can diff without fetching content. Memories are addressed by their `mem_...` ID; the path is the create key and can be changed via update.
190 A text document at a path inside a memory store.
183191
192 `content` is `null` when the response uses `view=basic`. `content_size_bytes` and `content_sha256` are always set, so you can detect changes without fetching the content. To retrieve, update, or delete a memory, pass its ID, which stays the same when its path changes.
193
194 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#view-and-edit-memories) to learn more about working with memories.
195
184196 - `type: "memory"`
185197
186198 - `id: string`
187199
188 Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory.
200 The unique ID of the memory (`mem_...`). It stays the same when the memory's path changes.
189201
202 To retrieve, update, or delete the memory, pass this ID.
203
190204 - `content_sha256: string`
191205
192206 Lowercase hex SHA-256 digest of the UTF-8 `content` bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a `content_sha256` precondition on update. Always populated, regardless of `view`.
from line 207
193207
194208 - `content_size_bytes: number`
195209
196 Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`.
210 The size of the memory's `content` in UTF-8 bytes. It is set regardless of `view`.
197211
198212 format: int32
199213
from line 223
209223
210224 - `memory_version_id: string`
211225
212 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list?sdk_languages=http).
226 The ID of the memory version that holds the memory's current content (`memver_...`).
213227
228 Memory versions don't have a flag that marks the latest one. Compare their IDs with this field instead.
229
230 See the [memory guide](https://platform.claude.com/docs/en/managed-agents/memory?sdk_languages=http#audit-memory-changes) to learn more about memory versions.
231
214232 - `path: string`
215233
216234 Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.
from line 235
217235
218236 - `updated_at: string`
219237
220 When this memory was last modified, in RFC 3339 format. Use this as a cheap freshness signal; for who made the change, look up the head version's `created_by` via [List memory versions](https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/list?sdk_languages=http).
238 When the memory was last changed, in RFC 3339.
221239
240 To find out who made the change, look at `created_by` on the memory version that `memory_version_id` references.
241
222242 format: date-time
223243
224244 - `content: optional string or null`
225245
226 The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes).
246 The memory's UTF-8 text content, or `null` when the response uses `view=basic`.
227247
248 The maximum size is 100 kB (102,400 bytes).
249
228250 - `BetaManagedAgentsMemoryPrefix object`
229251
230 A rolled-up directory marker returned by [List memories](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/list?sdk_languages=http) when `depth` is set. Indicates that one or more memories exist deeper than the requested depth under this prefix. This is a list-time rollup, not a stored resource; it has no ID and no lifecycle. Each prefix counts toward the page `limit` and interleaves with `memory` items in path order.
252 A directory marker that [List Memories](https://platform.claude.com/docs/en/api/beta/memory_stores/memories/list?sdk_languages=http) returns instead of the memories below the requested `depth`.
231253
254 It stands for one or more memories whose paths start with `path`. It isn't a stored object and doesn't have an ID. Each marker counts toward the page `limit`.
255
232256 - `type: "memory_prefix"`
233257
234258 - `path: string`
from line 261
237261
238262- `next_page: optional string or null`
239263
240 Opaque cursor for the next page (a `page_...` value), or `null` if there are no more results. Pass as `page` on the next request.
264 The value to pass as `page` to get the next page, or `null` if there are no more results.
241265
242266## Example
243267
No line in this hunk matches that.