> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory-temp-snowcone-command.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Update container tag settings

> Update settings for a container tag



## OpenAPI

````yaml https://api.supermemory.ai/v3/openapi patch /v3/container-tags/{containerTag}
openapi: 3.1.0
info:
  title: supermemory API
  description: The Memory API for the AI era
  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: Spaces
    description: Organize content into spaces (container tags)
  - name: Knowledge Graph
    description: Knowledge graph and entity relationships
  - name: Connections
    description: External service integrations
  - name: Settings
    description: Organization settings
  - name: Analytics
    description: Usage analytics and insights
  - name: Documents
    description: List, get, and search documents
paths:
  /v3/container-tags/{containerTag}:
    patch:
      tags:
        - Container Tags
      summary: Update container tag settings
      description: Update settings for a container tag
      operationId: patchV3ContainerTagsByContainerTag
      parameters:
        - schema:
            type: string
          in: path
          name: containerTag
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: >-
                    Display name for this container tag. This does not change
                    the container tag identifier.
                  example: Research Notes
                  minLength: 1
                  maxLength: 100
                  type: string
                entityContext:
                  description: >-
                    Custom context prompt for this container tag. Used to
                    provide additional context when processing documents in this
                    container. Maximum 1500 characters.
                  example: >-
                    This project contains research papers about machine
                    learning.
                  maxLength: 1500
                  anyOf:
                    - type: string
                      maxLength: 1500
                    - type: 'null'
                memoryFilesystemPaths:
                  anyOf:
                    - type: array
                      items:
                        type: string
                    - type: 'null'
                  description: >-
                    Per-tag allowlist of filesystem paths that trigger memory
                    generation for mount-ingested documents. Docs whose filepath
                    does not match are ingested as 'superrag' (chunked and
                    searchable, no memory extraction).
                  example:
                    - /memory/
                    - /user.md
                  hidden: true
                profileBuckets:
                  description: >-
                    Container-tag-level buckets to set (add-only on top of org
                    buckets). Replaces this tag's own bucket list; cannot
                    override or remove org buckets.
                  maxItems: 50
                  type: array
                  items:
                    type: object
                    properties:
                      key:
                        type: string
                        minLength: 1
                        maxLength: 64
                        pattern: ^[a-z0-9][a-z0-9_-]*$
                        description: Stable slug for the bucket, stored on each memory
                      description:
                        default: ''
                        description: >-
                          What belongs in this bucket — used to guide the
                          ingestion classifier.
                        type: string
                        maxLength: 2000
                    required:
                      - key
                    description: Definition of a single profile bucket
              description: Request body for updating container tag settings
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  containerTag:
                    type: string
                    maxLength: 100
                    pattern: ^[a-zA-Z0-9_:-]+$
                    description: The container tag identifier
                    example: sm_project_default
                  name:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Display name for this container tag
                  entityContext:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: >-
                      Custom context prompt for this container tag. Used to
                      provide additional context when processing documents in
                      this container.
                    example: >-
                      This project contains research papers about machine
                      learning.
                  memoryFilesystemPaths:
                    anyOf:
                      - type: array
                        items:
                          type: string
                      - type: 'null'
                    description: >-
                      Per-tag allowlist of filesystem paths that trigger memory
                      generation for mount-ingested documents. Docs whose
                      filepath does not match are ingested as 'superrag'
                      (chunked and searchable, no memory extraction).
                    example:
                      - /memory/
                      - /user.md
                    hidden: true
                  profileBuckets:
                    maxItems: 50
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                          minLength: 1
                          maxLength: 64
                          pattern: ^[a-z0-9][a-z0-9_-]*$
                          description: Stable slug for the bucket, stored on each memory
                        description:
                          default: ''
                          description: >-
                            What belongs in this bucket — used to guide the
                            ingestion classifier.
                          type: string
                          maxLength: 2000
                      required:
                        - key
                      description: Definition of a single profile bucket
                    description: >-
                      Container-tag-level buckets added on top of the org
                      buckets (add-only)
                  updatedAt:
                    type: string
                    description: Last update timestamp
                    format: datetime
                required:
                  - containerTag
                  - name
                  - entityContext
                  - memoryFilesystemPaths
                  - profileBuckets
                  - updatedAt
                description: Response after updating container tag settings
          description: Container tag settings updated successfully
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  details:
                    description: Additional error details
                    example: Query must be at least 1 character long
                    type: string
                  error:
                    type: string
                    description: Error message
                    example: Invalid request parameters
                required:
                  - error
          description: Bad request
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  details:
                    description: Additional error details
                    example: Query must be at least 1 character long
                    type: string
                  error:
                    type: string
                    description: Error message
                    example: Invalid request parameters
                required:
                  - error
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  details:
                    description: Additional error details
                    example: Query must be at least 1 character long
                    type: string
                  error:
                    type: string
                    description: Error message
                    example: Invalid request parameters
                required:
                  - error
          description: Container tag not found
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````