Update container tag settings

Update settings for a container tag

PATCH /v3/container-tags/{containerTag}

TypeScript

TypeScript

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.supermemory.ai/v3/container-tags/{containerTag}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.supermemory.ai/v3/container-tags/{containerTag}"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

curl -X PATCH "https://api.supermemory.ai/v3/container-tags/user_123" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ }'

200

{
  "containerTag": "sm_project_default",
  "name": "<string>",
  "entityContext": "This project contains research papers about machine learning.",
  "memoryFilesystemPaths": [
    "/memory/",
    "/user.md"
  ],
  "profileBuckets": [
    {
      "key": "<string>",
      "description": ""
    }
  ],
  "updatedAt": "<string>"
}

{
  "error": "Invalid request parameters",
  "details": "Query must be at least 1 character long"
}

{
  "error": "Invalid request parameters",
  "details": "Query must be at least 1 character long"
}

{
  "error": "Invalid request parameters",
  "details": "Query must be at least 1 character long"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

containerTag · string · required

Body

application/json

Request body for updating container tag settings

name · string

Display name for this container tag. This does not change the container tag identifier.

Required string length: 1 - 100

Example:

"Research Notes"

entityContext · string

Custom context prompt for this container tag. Used to provide additional context when processing documents in this container. Maximum 1500 characters.

Maximum string length: 1500

Example:

"This project contains research papers about machine learning."

memoryFilesystemPaths · string[] | null

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"]

profileBuckets · object[]

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.

Maximum array length: 50

Show child attributes

Response

200

application/json

Container tag settings updated successfully

Response after updating container tag settings

containerTag · string · required

The container tag identifier

Maximum string length: 100

Pattern: ^[a-zA-Z0-9_:-]+$

Example:

"sm_project_default"

name · string | null · required

Display name for this container tag

entityContext · string | null · required

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 · string[] | null · required

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"]

profileBuckets · object[] · required

Container-tag-level buckets added on top of the org buckets (add-only)

Maximum array length: 50

Show child attributes

updatedAt · string<datetime> · required

Last update timestamp