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

# List all container tags

> List all container tags with isNova flag



## OpenAPI

````yaml https://api.supermemory.ai/v4/openapi get /v3/container-tags/list
openapi: 3.1.0
info:
  title: supermemory API
  description: >-
    The Memory API for the AI era. OpenAPI operations include x-codeSamples for
    the official TypeScript and Python SDKs (Mintlify-compatible).
  version: 3.0.0
servers:
  - description: Production Server
    url: https://api.supermemory.ai
security:
  - bearerAuth: []
tags:
  - name: Ingest
    description: Ingest documents, files, URLs, conversations, and other content
  - name: Recall (Search)
    description: >-
      Semantic recall across your content — supports memories, hybrid, and
      documents modes
  - name: Profiles
    description: >-
      Entity profiles for users, participants, or any entity — includes profile
      search
  - name: Content Management
    description: List, get, update, and delete content and memories
  - name: Container Tags
    description: List and manage container tags (spaces) — settings, merge, and delete
  - name: Connections
    description: External service integrations
  - name: Settings
    description: Organization settings
  - name: Documents
    description: List, get, and search documents
  - name: Feedback
    description: Report bugs, request features, and flag documentation issues
paths:
  /v3/container-tags/list:
    get:
      tags:
        - Container Tags
      summary: List all container tags
      description: List all container tags with isNova flag
      operationId: getV3ContainerTagsList
      parameters:
        - in: query
          name: containerTags
          schema:
            type: string
          description: Comma-separated container tags to limit the list to
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Unique identifier of the space/container tag
                    name:
                      type: string
                      description: Display name
                    containerTag:
                      type: string
                      description: Container tag identifier
                    description:
                      description: >-
                        Auto-maintained, keyword-dense summary of the
                        container's recurring topics, refreshed on each
                        ingestion. Use it to pick the right container tag to
                        read from or write to.
                      type:
                        - string
                        - 'null'
                    createdAt:
                      type: string
                      description: Creation timestamp
                      format: datetime
                    updatedAt:
                      type: string
                      description: Last update timestamp
                      format: datetime
                    isExperimental:
                      type: boolean
                      description: Whether the space is in experimental mode
                    emoji:
                      description: Emoji icon
                      type: string
                    visibility:
                      description: >-
                        Space visibility: public (org-shared) or private
                        (owner-only)
                      type: string
                      enum:
                        - public
                        - private
                        - unlisted
                    isNova:
                      type: boolean
                      description: Whether this is a Nova space (sm_project_* prefix)
                    documentCount:
                      type: number
                      description: Number of documents linked to this container tag
                    memoryCount:
                      type: number
                      description: >-
                        Number of active memory entries (latest, not forgotten)
                        in this container tag
                    lastActivityAt:
                      description: >-
                        Most recent activity timestamp across documents and
                        memories
                      format: datetime
                      type:
                        - string
                        - 'null'
                    mergeStatus:
                      description: Whether this tag is involved in an active merge
                      type: string
                      enum:
                        - source
                        - target
                    mergeId:
                      description: Active merge job identifier
                      type: string
                    mergeTargetTag:
                      description: Target tag for an active source-tag merge
                      type: string
                  required:
                    - id
                    - name
                    - containerTag
                    - description
                    - createdAt
                    - updatedAt
                    - isExperimental
                    - isNova
                    - documentCount
                    - memoryCount
                    - lastActivityAt
                  description: Container tag with isNova flag and aggregate counts
                description: Flat array of all container tags with isNova flag
          description: Container tags list
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal server error
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl "https://api.supermemory.ai/v3/container-tags/list" \
              -H "Authorization: Bearer $SUPERMEMORY_API_KEY"
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
          example: Invalid request parameters
        details:
          type: string
          description: Additional error details
          example: Query must be at least 1 character long
      required:
        - error
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.