> ## 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:
  - description: List models available through the AI Router.
    name: Models
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: API keys
    description: >-
      API keys authenticate programmatic access to the workspace. The unified
      key model exposes opaque tokens, per-domain access grants, and budget /
      rate-limit constraints (see ADR 0001 and ADR 0002).
  - name: Budgets
    description: >-
      Budgets govern spend, token usage, and request rate across six scopes:
      workspace, project, identity, api-key, provider, and model. A budget is
      hierarchical and defense-in-depth — every applicable budget is a hard
      gate, and the most restrictive one wins per dimension (see ADR 0007).
  - name: Documentation
    description: >-
      Search the orq.ai documentation. Proxies the workspace's query to the
      hosted docs search index.
  - name: Files
    description: File upload and retrieval operations.
  - name: Identities
    description: >-
      Identities represent end users from your system for usage and engagement
      tracking.
  - name: Projects
    description: Projects organize resources within a workspace
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Embeddings
  - 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.
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
                            - 'null'
                          description: The user ID of the creator
                        updated_by_id:
                          type:
                            - string
                            - 'null'
                          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

````