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

# List Projects

> Returns a list of all projects.

Projects are isolated memory namespaces. Memories (episodes) belong
exclusively to their project. All project operations, including queries and
any background processes (e.g., memory summarization or knowledge
extraction), only operate within the project's own data. No cross-project
access is allowed.




## OpenAPI

````yaml /platform.openapi.json post /v2/projects/list
openapi: 3.0.4
info:
  description: >-
    Public REST API for the MemMachine memory system. Manages projects and
    memories.
  title: MemMachine Public API
  version: 0.1.0
servers:
  - url: https://api.memmachine.ai
security:
  - BearerAuth: []
tags:
  - name: Projects
  - name: Memories
  - name: Metrics
  - name: Health
paths:
  /v2/projects/list:
    post:
      tags:
        - Projects
      summary: List Projects
      description: >
        Returns a list of all projects.


        Projects are isolated memory namespaces. Memories (episodes) belong

        exclusively to their project. All project operations, including queries
        and

        any background processes (e.g., memory summarization or knowledge

        extraction), only operate within the project's own data. No
        cross-project

        access is allowed.
      operationId: ListProjects
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ProjectResponse'
                type: array
          description: Successful Response
        default:
          $ref: '#/components/responses/UnexpectedError'
components:
  schemas:
    ProjectResponse:
      description: >
        Response model returned after project operations (e.g., creation,
        update, fetch).


        Contains the resolved identifiers and configuration of the project as
        stored

        in the system. Field formats follow the same validation rules as in

        `CreateProjectSpec`.
      properties:
        config:
          $ref: '#/components/schemas/ProjectConfig'
        description:
          default: ''
          description: |
            A human-readable description of the project.
            Used for display purposes in UIs and dashboards.
            Optional; defaults to an empty string.
          title: Description
          type: string
        org_id:
          description: |
            The unique identifier of the organization this project belongs to.

            Returned exactly as stored by the system.
          maxLength: 255
          title: Org Id
          type: string
        project_id:
          description: |
            The identifier of the project.

            This value uniquely identifies the project within the organization.
          maxLength: 255
          title: Project Id
          type: string
      required:
        - org_id
        - project_id
      title: ProjectResponse
      type: object
    ProjectConfig:
      description: >
        Project configuration model.


        This section defines which reranker and embedder models should be used
        for

        the project.  If any field is left empty (""), the system automatically
        falls

        back to the globally configured defaults in the server configuration
        file.
      properties:
        embedder:
          default: ''
          description: >
            The name of the embedder model to use for this project.


            - Must refer to an embedder model defined in the system
            configuration.

            - If set to an empty string (default), the globally configured
            embedder will
              be used.

            Embedders generate vector embeddings for text to support semantic
            search and

            similarity operations.
          example: bge-base-en
          title: Embedder
          type: string
        reranker:
          default: ''
          description: >
            The name of the reranker model to use for this project.


            - Must refer to a reranker model defined in the system
            configuration.

            - If set to an empty string (default), the globally configured
            reranker will
              be used.

            Rerankers typically re-score retrieved documents to improve result
            quality.
          example: bge-reranker-large
          title: Reranker
          type: string
      title: ProjectConfig
      type: object
    Error:
      properties:
        code:
          description: Error code.
          format: int32
          type: integer
        message:
          description: Error message.
          type: string
      required:
        - code
        - message
      type: object
  responses:
    UnexpectedError:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Unexpected error.
  securitySchemes:
    BearerAuth:
      scheme: bearer
      type: http

````