> ## 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 Semantic Category Templates

> List semantic category templates for a set type.

    Returns all categories defined on a set type. These categories
    are inherited by sets mapped to the set type.



## OpenAPI

````yaml /openapi.json post /api/v2/memories/semantic/category/template/list
openapi: 3.1.0
info:
  title: MemMachine API
  version: 0.3.10
  description: >-
    Architectural Memory Systems for AI Agents. Specialized in episodic and
    semantic memory management with strict namespace isolation.
servers:
  - url: http://localhost:8080
security: []
tags:
  - name: Configuration
    description: System overview and memory subsystem configuration.
  - name: Episodic Configuration
    description: Per-project episodic memory subsystem configuration.
  - name: Memories
    description: Core operations for episodic and semantic memory ingestion and retrieval.
  - name: Projects
    description: Lifecycle management for isolated memory namespaces.
  - name: Resources
    description: Embedder, language model, and reranker lifecycle management.
  - name: 'Semantic Memory: Categories'
    description: Category, template, and tag management for semantic sets.
  - name: 'Semantic Memory: Features'
    description: Add, retrieve, and update individual semantic features.
  - name: 'Semantic Memory: Sets'
    description: Set type and set ID lifecycle, listing, and configuration.
  - name: System
    description: Infrastructure, health, and observability.
paths:
  /api/v2/memories/semantic/category/template/list:
    post:
      tags:
        - 'Semantic Memory: Categories'
      summary: List Semantic Category Templates
      description: |-
        List semantic category templates for a set type.

            Returns all categories defined on a set type. These categories
            are inherited by sets mapped to the set type.
      operationId: list_semantic_category_templates
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListSemanticCategoryTemplatesSpec'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSemanticCategoryTemplatesResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ListSemanticCategoryTemplatesSpec:
      properties:
        org_id:
          type: string
          title: Org Id
          description: |2-

                The unique identifier of the organization.

                - Must not contain slashes (`/`).
                - Must contain only letters, numbers, underscores, hyphens, colon, and Unicode
                  characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
                  are allowed.

                This value determines the namespace the project belongs to.
                
          default: universal
          examples:
            - MemVerge
            - AI_Labs
        project_id:
          type: string
          title: Project Id
          description: |2-

                The identifier of the project.

                - Must be unique within the organization.
                - Must not contain slashes (`/`).
                - Must contain only letters, numbers, underscores, hyphens, colon, and Unicode
                  characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
                  are allowed.

                This ID is used in API paths and resource locations.
                
          default: universal
          examples:
            - memmachine
            - research123
            - qa_pipeline
        set_type_id:
          type: string
          title: Set Type Id
          description: |2-

                Unique identifier for the semantic set type.
      type: object
      required:
        - set_type_id
      title: ListSemanticCategoryTemplatesSpec
      description: Specification model for listing semantic category templates.
    ListSemanticCategoryTemplatesResponse:
      properties:
        categories:
          items:
            $ref: '#/components/schemas/SemanticCategoryTemplateEntry'
          type: array
          title: Categories
          description: |2-

                List of semantic categories.
      type: object
      required:
        - categories
      title: ListSemanticCategoryTemplatesResponse
      description: Response model for listing semantic category templates.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SemanticCategoryTemplateEntry:
      properties:
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
          description: |2-

                Unique identifier for the semantic category.
        name:
          type: string
          title: Name
          description: |2-

                Human-readable name for the category. Categories group related features
                together for extraction and organization.
        origin_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Origin Type
          description: |2-

                The origin type of the category: 'set_id' for local categories or
                'set_type' for inherited template categories.
        origin_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Origin Id
          description: |2-

                The identifier of the origin (set_id or set_type_id) where the category
                was defined.
        inherited:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Inherited
          description: |2-

                Whether this category is inherited from a set type template.
      type: object
      required:
        - name
      title: SemanticCategoryTemplateEntry
      description: A semantic category template entry.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````