> ## 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 Superagent memories

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

Lists what a Superagent remembers that applies to you.

The list holds the agent's `global` memories, which apply to every user, and your own `user` memories. It returns the 200 most recent, newest first.

<Note>This endpoint accepts a personal API key or personal access token belonging to a user with access to the agent. Workspace API keys are not accepted.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/agents/{agent_id}/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/agents/{agent_id}/memory:
    get:
      summary: List Superagent memories
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Lists what a Superagent remembers that applies to you.


        The list holds the agent's `global` memories, which apply to every user,
        and your own `user` memories. It returns the 200 most recent, newest
        first.


        <Note>This endpoint accepts a personal API key or personal access token
        belonging to a user with access to the agent. Workspace API keys are not
        accepted.</Note>


        <Warning>The response includes fields beyond the ones documented here.
        Don't rely on undocumented response fields, as they can change at any
        time.</Warning>
      operationId: list_memory_items_api_agents__agent_id__memory_get
      parameters:
        - name: agent_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the Superagent. It's the agent's app ID, shown in the
              agent's developer settings.
            title: Agent Id
          description: >-
            ID of the Superagent. It's the agent's app ID, shown in the agent's
            developer settings.
          example: 6820f3a4e7b91d003c45a1f2
      responses:
        '200':
          description: The memories that apply to you.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuperagentMemory'
                title: SuperagentMemories
        '400':
          description: '`agent_id` belongs to an app that isn''t a Superagent.'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: You don't have access to this agent, or your API key is read-only.
        '404':
          description: Agent not found.
        '429':
          description: Rate limit exceeded (100 requests per minute).
components:
  schemas:
    SuperagentMemory:
      properties:
        id:
          type: string
          title: Id
          description: ID of the memory.
          example: 68a1c9b2f0b9d3002e7a5c3d
        content:
          type: string
          title: Content
          description: What the agent remembers.
          example: Prefers weekly reports on Monday mornings.
        scope:
          type: string
          enum:
            - global
            - user
          title: Scope
          description: >-
            Who the memory applies to. `global` memories apply to every user of
            the agent, and `user` memories only to you.
          example: user
        user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: User Id
          description: >-
            ID of the user the memory belongs to when `scope` is `user`, or
            `null` for a `global` memory.
          example: 6820f41be7b91d003c45a20a
        conversation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Conversation Id
          description: >-
            ID of the conversation the agent created the memory in, or `null`
            when it wasn't created in one.
          example: 68a1c2e4f0b9d3002e7a5c11
        created_date:
          type: string
          format: date-time
          title: Created Date
          description: Time the memory was created, as a UTC timestamp in ISO 8601 format.
          example: '2026-08-02T14:30:00Z'
        updated_date:
          type: string
          format: date-time
          title: Updated Date
          description: Time the memory last changed, as a UTC timestamp in ISO 8601 format.
          example: '2026-08-02T14:30:00Z'
      type: object
      required:
        - id
        - content
        - scope
        - user_id
        - conversation_id
        - created_date
        - updated_date
      title: SuperagentMemory
      description: Something the Superagent remembers.
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.