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

# Get Memory

> Paginated listing over the requested ``memory_type``.



## OpenAPI

````yaml /api-reference/openapi-oss.json post /api/v1/memory/get
openapi: 3.1.0
info:
  title: everos
  description: md-first memory extraction framework
  version: 0.1.0
servers: []
security: []
paths:
  /api/v1/memory/get:
    post:
      tags:
        - memory
      summary: Get Memory
      description: Paginated listing over the requested ``memory_type``.
      operationId: post_get_api_v1_memory_get_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    GetRequest:
      properties:
        user_id:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          title: User Id
        agent_id:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          title: Agent Id
        app_id:
          type: string
          title: App Id
          default: default
        project_id:
          type: string
          title: Project Id
          default: default
        memory_type:
          $ref: '#/components/schemas/GetMemoryType'
        page:
          type: integer
          minimum: 1
          title: Page
          default: 1
        page_size:
          type: integer
          maximum: 100
          minimum: 1
          title: Page Size
          default: 20
        sort_by:
          type: string
          enum:
            - timestamp
            - updated_at
          title: Sort By
          default: timestamp
        sort_order:
          type: string
          enum:
            - asc
            - desc
          title: Sort Order
          default: desc
        filters:
          anyOf:
            - $ref: '#/components/schemas/FilterNode'
            - type: 'null'
      additionalProperties: false
      type: object
      required:
        - memory_type
      title: GetRequest
      description: |-
        Request body for ``POST /api/v1/memory/get``.

        Callers identify the memory owner via ``user_id`` XOR ``agent_id`` —
        exactly one must be set. Internally the manager keeps using
        ``owner_id`` / ``owner_type`` (the storage tables' columns); those
        are exposed as derived properties so the rename only affects the
        wire contract.
    GetResponse:
      properties:
        request_id:
          type: string
          title: Request Id
        data:
          $ref: '#/components/schemas/GetData'
      additionalProperties: false
      type: object
      required:
        - request_id
        - data
      title: GetResponse
      description: Top-level response envelope.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    GetMemoryType:
      type: string
      enum:
        - episode
        - profile
        - agent_case
        - agent_skill
      title: GetMemoryType
      description: |-
        The four kinds enumerated by ``/get``.

        ``episode`` and ``profile`` are user-owned; ``agent_case`` and
        ``agent_skill`` are agent-owned. Cross-pairs are rejected by
        :meth:`GetRequest._validate_owner_memory_type_pair`.

        Naming note: all four values use the bare kind name (no
        ``_memory`` suffix) and match the LanceDB table name + everalgo
        type name for that kind.
    FilterNode:
      properties:
        AND:
          anyOf:
            - items:
                $ref: '#/components/schemas/FilterNode'
              type: array
            - type: 'null'
          title: And
        OR:
          anyOf:
            - items:
                $ref: '#/components/schemas/FilterNode'
              type: array
            - type: 'null'
          title: Or
      additionalProperties: true
      type: object
      title: FilterNode
      description: |-
        One Filters DSL node.

        Recursive ``AND`` / ``OR`` arrays mix with arbitrary scalar fields at
        the same level. Pydantic only checks the combinators; field-level
        safety is enforced when compiling the node to a LanceDB ``where``
        string in :mod:`everos.memory.search.filters`.
    GetData:
      properties:
        episodes:
          items:
            $ref: '#/components/schemas/GetEpisodeItem'
          type: array
          title: Episodes
        profiles:
          items:
            $ref: '#/components/schemas/GetProfileItem'
          type: array
          title: Profiles
        agent_cases:
          items:
            $ref: '#/components/schemas/GetAgentCaseItem'
          type: array
          title: Agent Cases
        agent_skills:
          items:
            $ref: '#/components/schemas/GetAgentSkillItem'
          type: array
          title: Agent Skills
        total_count:
          type: integer
          title: Total Count
          default: 0
        count:
          type: integer
          title: Count
          default: 0
      additionalProperties: false
      type: object
      title: GetData
      description: |-
        Body of ``response.data``.

        All four arrays are always present so client code can iterate
        without branching on ``memory_type``; the route populates exactly
        one.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    GetEpisodeItem:
      properties:
        id:
          type: string
          title: Id
        user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: User Id
        app_id:
          type: string
          title: App Id
          default: default
        project_id:
          type: string
          title: Project Id
          default: default
        session_id:
          type: string
          title: Session Id
        timestamp:
          type: string
          format: date-time
          title: Timestamp
        sender_ids:
          items:
            type: string
          type: array
          title: Sender Ids
        summary:
          type: string
          title: Summary
        subject:
          type: string
          title: Subject
        episode:
          type: string
          title: Episode
        type:
          type: string
          const: Conversation
          title: Type
      additionalProperties: false
      type: object
      required:
        - id
        - user_id
        - session_id
        - timestamp
        - summary
        - subject
        - episode
        - type
      title: GetEpisodeItem
      description: Episode listing item — always user-scoped.
    GetProfileItem:
      properties:
        id:
          type: string
          title: Id
        user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: User Id
        app_id:
          type: string
          title: App Id
          default: default
        project_id:
          type: string
          title: Project Id
          default: default
        profile_data:
          additionalProperties: true
          type: object
          title: Profile Data
      additionalProperties: false
      type: object
      required:
        - id
        - user_id
        - profile_data
      title: GetProfileItem
      description: Owner profile — at most one per response, only for user owners.
    GetAgentCaseItem:
      properties:
        id:
          type: string
          title: Id
        agent_id:
          type: string
          title: Agent Id
        app_id:
          type: string
          title: App Id
          default: default
        project_id:
          type: string
          title: Project Id
          default: default
        session_id:
          type: string
          title: Session Id
        task_intent:
          type: string
          title: Task Intent
        approach:
          type: string
          title: Approach
        quality_score:
          type: number
          title: Quality Score
        key_insight:
          anyOf:
            - type: string
            - type: 'null'
          title: Key Insight
        timestamp:
          type: string
          format: date-time
          title: Timestamp
      additionalProperties: false
      type: object
      required:
        - id
        - agent_id
        - session_id
        - task_intent
        - approach
        - quality_score
        - timestamp
      title: GetAgentCaseItem
      description: Agent case listing item — always agent-scoped.
    GetAgentSkillItem:
      properties:
        id:
          type: string
          title: Id
        agent_id:
          type: string
          title: Agent Id
        app_id:
          type: string
          title: App Id
          default: default
        project_id:
          type: string
          title: Project Id
          default: default
        name:
          type: string
          title: Name
        description:
          type: string
          title: Description
        content:
          type: string
          title: Content
        confidence:
          type: number
          title: Confidence
        maturity_score:
          type: number
          title: Maturity Score
        source_case_ids:
          items:
            type: string
          type: array
          title: Source Case Ids
      additionalProperties: false
      type: object
      required:
        - id
        - agent_id
        - name
        - description
        - content
        - confidence
        - maturity_score
      title: GetAgentSkillItem
      description: Agent skill listing item — always agent-scoped.

````