# List memory entries

Launch stage: Beta

`GET /api/2.0/agents/{parent=memory-stores/*}/entries`

Lists memory entries for one actor. An exact `path` filters entries across sessions,
 ignoring session metadata. Otherwise, `session_id` and `path_prefix` restrict the actor
 partition. `view` controls whether each returned entry includes memory content.

API scopes: agent-kit

## Path parameters

- `parent` (string, required)
  Memory store whose entries are listed, in the form
   `memory-stores/{managed_memory_store_id}`.

## Query parameters

- `page_size` (int32, optional)
  Maximum number of entries to return. The service may return fewer entries than requested.
   Defaults to 10; must be between 1 and 100.
- `page_token` (string, optional)
  Opaque pagination token from a previous ListManagedMemoryEntries response.
- `actor_id` (string, required)
  Customer-provided identifier for the actor whose entries are listed.
- `path_prefix` (string, optional)
  Optional path prefix used to restrict entries within the actor partition.
- `session_id` (string, optional)
  Optional session identifier. When set, only entries with this exact `session_id` are
   returned. Omitted-session (cross-session) entries are not included. Ignored when path is set.

## Returns

Returns a list of ManagedMemoryEntry objects.

## Response

```json
{
  "managed_memory_entries": [
    {
      "name": "string",
      "actor_id": "string",
      "session_id": "string",
      "path": "string",
      "content": "string",
      "description": "string",
      "source_type": "MANAGED_MEMORY_ENTRY_SOURCE_TYPE_AGENT",
      "create_time": "string",
      "update_time": "string"
    }
  ],
  "next_page_token": "string"
}
```