> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List agent memories

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns what one of the app's agents remembers, newest first.

An agent saves a memory when it learns something worth keeping. A memory can apply to everyone or to one app user, so it can hold personal data about that user.

You get up to 200 memories, and there's no pagination.

This is limited to 60 requests a minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key, including a read-only one, from anyone with access to the app, viewers included. Workspace API keys are not authorized for it.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/agent-configs/{name}/memory
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/agent-configs/{name}/memory:
    get:
      summary: List agent memories
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns what one of the app's agents remembers, newest first.


        An agent saves a memory when it learns something worth keeping. A memory
        can apply to everyone or to one app user, so it can hold personal data
        about that user.


        You get up to 200 memories, and there's no pagination.


        This is limited to 60 requests a minute per app for each workspace's
        personal API keys, so every key in a workspace shares one allowance.
        Some workspaces have a different limit.


        <Note>This endpoint accepts a personal API key, including a read-only
        one, from anyone with access to the app, viewers included. Workspace API
        keys are not authorized for it.</Note>
      operationId: list_memory_items_api_apps__app_id__agent_configs__name__memory_get
      parameters:
        - name: name
          in: path
          required: true
          schema:
            type: string
            description: Name of the agent.
            title: Name
          description: Name of the agent.
          example: support_agent
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose agents to read.
            title: App Id
          description: ID of the app whose agents to read.
          example: 6820f3a4e7b91d003c45a1f2
      responses:
        '200':
          description: The agent's memories, newest first.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AgentMemoryItem'
                title: >-
                  Response 200 List Memory Items Api Apps  App Id  Agent
                  Configs  Name  Memory Get
        '401':
          description: Missing or invalid credentials.
        '403':
          description: You don't have access to this app, or you used a workspace API key.
        '404':
          description: App not found, or the app has no agent with this name.
        '429':
          description: >-
            Too many requests for this app in the last minute from personal API
            keys in your workspace.
components:
  schemas:
    AgentMemoryItem:
      properties:
        id:
          type: string
          title: Id
          description: ID of the memory.
          example: 68a1d2c3e4f5061728394a7d
        app_id:
          type: string
          title: App Id
          description: ID of the app.
          example: 6820f3a4e7b91d003c45a1f2
        agent_name:
          type: string
          title: Agent Name
          description: Name of the agent the memory belongs to.
          example: support_agent
        content:
          type: string
          title: Content
          description: What the agent remembered, in its own words.
          example: Prefers delivery updates by email rather than SMS.
        scope:
          type: string
          title: Scope
          description: >-
            `global` for a memory the agent uses with every user, or `user` for
            one it uses only with the user in `user_id`.
          example: user
        user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: User Id
          description: >-
            ID of the app user a `user` memory belongs to, or `null` for a
            `global` memory.
          example: 68a1d2c3e4f5061728394a6c
        conversation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Conversation Id
          description: >-
            ID of the conversation the agent saved the memory in, or `null` if
            it wasn't saved in one.
          example: 68a1d2c3e4f5061728394a5b
        created_date:
          type: string
          title: Created Date
          description: When the memory was saved, as a UTC timestamp in ISO 8601 format.
          example: '2026-01-15T09:31:07'
        updated_date:
          type: string
          title: Updated Date
          description: >-
            When the memory was last changed, as a UTC timestamp in ISO 8601
            format.
          example: '2026-01-15T09:31:07'
      type: object
      required:
        - id
        - app_id
        - agent_name
        - content
        - scope
        - created_date
        - updated_date
      title: AgentMemoryItem
      description: One thing an agent remembered.
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````