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

# List memory stores

> Retrieves a paginated list of memory stores in the workspace. Use cursor-based pagination parameters to navigate through the results.



## OpenAPI

````yaml get /v2/memory-stores
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: Files
    description: File upload and retrieval operations.
  - name: FilesService
  - name: Projects
    description: Projects organize resources within a workspace
  - name: ProjectsService
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: SkillsService
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
  - name: ReportingService
    description: |-
      ReportingService exposes a single QueryReport RPC that maps allowlisted
       analytics payloads onto safe rollup queries. Callers never send SQL;
       the backend picks the rollup family and grain from the metric
       catalogue, the requested range, and the requested grouping.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v2/memory-stores:
    get:
      tags:
        - Memory Stores
      summary: List memory stores
      description: >-
        Retrieves a paginated list of memory stores in the workspace. Use
        cursor-based pagination parameters to navigate through the results.
      operationId: GetAllMemoryStores
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 200
            default: 10
            description: >-
              A limit on the number of objects to be returned. Limit can range
              between 1 and 50, and the default is 10
          required: false
          description: >-
            A limit on the number of objects to be returned. Limit can range
            between 1 and 50, and the default is 10
          name: limit
          in: query
        - schema:
            type: string
            description: >-
              A cursor for use in pagination. `starting_after` is an object ID
              that defines your place in the list. For instance, if you make a
              list request and receive 20 objects, ending with
              `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include
              `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page
              of the list.
          required: false
          description: >-
            A cursor for use in pagination. `starting_after` is an object ID
            that defines your place in the list. For instance, if you make a
            list request and receive 20 objects, ending with
            `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include
            `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page
            of the list.
          name: starting_after
          in: query
        - schema:
            type: string
            description: >-
              A cursor for use in pagination. `ending_before` is an object ID
              that defines your place in the list. For instance, if you make a
              list request and receive 20 objects, starting with
              `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include
              `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous
              page of the list.
          required: false
          description: >-
            A cursor for use in pagination. `ending_before` is an object ID that
            defines your place in the list. For instance, if you make a list
            request and receive 20 objects, starting with
            `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include
            `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous
            page of the list.
          name: ending_before
          in: query
      responses:
        '200':
          description: Successfully retrieved the list of memory stores.
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - list
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                          description: The unique identifier of the memory store
                        key:
                          type: string
                          minLength: 1
                          maxLength: 255
                          pattern: ^[A-Za-z]([A-Za-z0-9]*([._][A-Za-z0-9]+)*)?$
                          description: >-
                            The unique key of the memory store. The key is
                            unique and inmmutable and cannot be repeated within
                            the same workspace.
                        description:
                          type: string
                          description: >-
                            The description of the memory store. Be as precise
                            as possible to help the AI to understand the purpose
                            of the memory store.
                        created_by_id:
                          type: string
                          description: The user ID of the creator
                        updated_by_id:
                          type: string
                          description: The user ID of the last updater
                        created:
                          type: string
                          description: The creation date of the memory store
                        updated:
                          type: string
                          description: The last update date of the memory store
                        ttl:
                          type: number
                          description: >-
                            The default time to live of every memory document
                            created within the memory store. Useful to control
                            if the documents in the memory should be store for
                            short or long term.
                        embedding_config:
                          type: object
                          properties:
                            model:
                              type: string
                              description: >-
                                The embeddings model to use for the knowledge
                                base in the format "provider/model" for public
                                models or "workspaceKey@provider/model" for
                                private workspace models. This model will be
                                used to embed the chunks when they are added to
                                the knowledge base. Refer to the (Supported
                                models)[/docs/proxy/supported-models] to browse
                                available models.
                          required:
                            - model
                      required:
                        - _id
                        - key
                        - description
                        - created
                        - updated
                        - embedding_config
                  has_more:
                    type: boolean
                required:
                  - object
                  - data
                  - has_more
        '401':
          description: Unauthorized - Bearer token is missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HonoApiError'
components:
  schemas:
    HonoApiError:
      type: object
      properties:
        code:
          type: string
          description: HTTP status code
        message:
          type: string
          description: Error message
      required:
        - message
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````