feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-008c99427a2471a387bd071f936b0a1e352b81cea24a7d329719c28c652738df.yml
-openapi_spec_hash: b47b3fdce4626adc8193b4c340e340ed
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-cb825424a78065806e278b10053f1fa86b058c5921cd1897493bbe162a5a46bf.yml
+openapi_spec_hash: fcaa9f922c209e43a9be57695f3ce6ad
 config_hash: f3eb5ca71172780678106f6d46f15dda

src/supermemory/_client.py

@@ -145,12 +145,14 @@ def search(self) -> SearchResource:
 
     @cached_property
     def settings(self) -> SettingsResource:
+        """Organization settings"""
         from .resources.settings import SettingsResource
 
         return SettingsResource(self)
 
     @cached_property
     def connections(self) -> ConnectionsResource:
+        """External service integrations"""
         from .resources.connections import ConnectionsResource
 
         return ConnectionsResource(self)
@@ -458,12 +460,14 @@ def search(self) -> AsyncSearchResource:
 
     @cached_property
     def settings(self) -> AsyncSettingsResource:
+        """Organization settings"""
         from .resources.settings import AsyncSettingsResource
 
         return AsyncSettingsResource(self)
 
     @cached_property
     def connections(self) -> AsyncConnectionsResource:
+        """External service integrations"""
         from .resources.connections import AsyncConnectionsResource
 
         return AsyncConnectionsResource(self)
@@ -729,12 +733,14 @@ def search(self) -> search.SearchResourceWithRawResponse:
 
     @cached_property
     def settings(self) -> settings.SettingsResourceWithRawResponse:
+        """Organization settings"""
         from .resources.settings import SettingsResourceWithRawResponse
 
         return SettingsResourceWithRawResponse(self._client.settings)
 
     @cached_property
     def connections(self) -> connections.ConnectionsResourceWithRawResponse:
+        """External service integrations"""
         from .resources.connections import ConnectionsResourceWithRawResponse
 
         return ConnectionsResourceWithRawResponse(self._client.connections)
@@ -773,12 +779,14 @@ def search(self) -> search.AsyncSearchResourceWithRawResponse:
 
     @cached_property
     def settings(self) -> settings.AsyncSettingsResourceWithRawResponse:
+        """Organization settings"""
         from .resources.settings import AsyncSettingsResourceWithRawResponse
 
         return AsyncSettingsResourceWithRawResponse(self._client.settings)
 
     @cached_property
     def connections(self) -> connections.AsyncConnectionsResourceWithRawResponse:
+        """External service integrations"""
         from .resources.connections import AsyncConnectionsResourceWithRawResponse
 
         return AsyncConnectionsResourceWithRawResponse(self._client.connections)
@@ -817,12 +825,14 @@ def search(self) -> search.SearchResourceWithStreamingResponse:
 
     @cached_property
     def settings(self) -> settings.SettingsResourceWithStreamingResponse:
+        """Organization settings"""
         from .resources.settings import SettingsResourceWithStreamingResponse
 
         return SettingsResourceWithStreamingResponse(self._client.settings)
 
     @cached_property
     def connections(self) -> connections.ConnectionsResourceWithStreamingResponse:
+        """External service integrations"""
         from .resources.connections import ConnectionsResourceWithStreamingResponse
 
         return ConnectionsResourceWithStreamingResponse(self._client.connections)
@@ -861,12 +871,14 @@ def search(self) -> search.AsyncSearchResourceWithStreamingResponse:
 
     @cached_property
     def settings(self) -> settings.AsyncSettingsResourceWithStreamingResponse:
+        """Organization settings"""
         from .resources.settings import AsyncSettingsResourceWithStreamingResponse
 
         return AsyncSettingsResourceWithStreamingResponse(self._client.settings)
 
     @cached_property
     def connections(self) -> connections.AsyncConnectionsResourceWithStreamingResponse:
+        """External service integrations"""
         from .resources.connections import AsyncConnectionsResourceWithStreamingResponse
 
         return AsyncConnectionsResourceWithStreamingResponse(self._client.connections)

src/supermemory/resources/connections.py

@@ -43,6 +43,8 @@
 
 
 class ConnectionsResource(SyncAPIResource):
+    """External service integrations"""
+
     @cached_property
     def with_raw_response(self) -> ConnectionsResourceWithRawResponse:
         """
@@ -457,6 +459,8 @@ def resources(
 
 
 class AsyncConnectionsResource(AsyncAPIResource):
+    """External service integrations"""
+
     @cached_property
     def with_raw_response(self) -> AsyncConnectionsResourceWithRawResponse:
         """

src/supermemory/resources/documents.py

@@ -453,6 +453,7 @@ def upload_file(
         self,
         *,
         file: FileTypes,
+        container_tag: str | Omit = omit,
         container_tags: str | Omit = omit,
         file_type: str | Omit = omit,
         metadata: str | Omit = omit,
@@ -471,6 +472,8 @@ def upload_file(
         Args:
           file: File to upload and process
 
+          container_tag: Optional container tag (e.g., 'user_123'). Use this for a single tag.
+
           container_tags: Optional container tags. Can be either a JSON string of an array (e.g.,
               '["user_123", "project_123"]') or a single string (e.g., 'user_123'). Single
               strings will be automatically converted to an array.
@@ -502,6 +505,7 @@ def upload_file(
         body = deepcopy_minimal(
             {
                 "file": file,
+                "container_tag": container_tag,
                 "container_tags": container_tags,
                 "file_type": file_type,
                 "metadata": metadata,
@@ -940,6 +944,7 @@ async def upload_file(
         self,
         *,
         file: FileTypes,
+        container_tag: str | Omit = omit,
         container_tags: str | Omit = omit,
         file_type: str | Omit = omit,
         metadata: str | Omit = omit,
@@ -958,6 +963,8 @@ async def upload_file(
         Args:
           file: File to upload and process
 
+          container_tag: Optional container tag (e.g., 'user_123'). Use this for a single tag.
+
           container_tags: Optional container tags. Can be either a JSON string of an array (e.g.,
               '["user_123", "project_123"]') or a single string (e.g., 'user_123'). Single
               strings will be automatically converted to an array.
@@ -989,6 +996,7 @@ async def upload_file(
         body = deepcopy_minimal(
             {
                 "file": file,
+                "container_tag": container_tag,
                 "container_tags": container_tags,
                 "file_type": file_type,
                 "metadata": metadata,

src/supermemory/resources/settings.py

@@ -25,6 +25,8 @@
 
 
 class SettingsResource(SyncAPIResource):
+    """Organization settings"""
+
     @cached_property
     def with_raw_response(self) -> SettingsResourceWithRawResponse:
         """
@@ -134,6 +136,8 @@ def get(
 
 
 class AsyncSettingsResource(AsyncAPIResource):
+    """Organization settings"""
+
     @cached_property
     def with_raw_response(self) -> AsyncSettingsResourceWithRawResponse:
         """

src/supermemory/types/document_upload_file_params.py

@@ -14,6 +14,9 @@ class DocumentUploadFileParams(TypedDict, total=False):
     file: Required[FileTypes]
     """File to upload and process"""
 
+    container_tag: Annotated[str, PropertyInfo(alias="containerTag")]
+    """Optional container tag (e.g., 'user_123'). Use this for a single tag."""
+
     container_tags: Annotated[str, PropertyInfo(alias="containerTags")]
     """Optional container tags.
 

tests/api_resources/test_documents.py

@@ -426,6 +426,7 @@ def test_method_upload_file(self, client: Supermemory) -> None:
     def test_method_upload_file_with_all_params(self, client: Supermemory) -> None:
         document = client.documents.upload_file(
             file=b"Example data",
+            container_tag="user",
             container_tags='["user_123", "project_123"]',
             file_type="image",
             metadata='{"category": "technology", "isPublic": true, "readingTime": 5}',
@@ -866,6 +867,7 @@ async def test_method_upload_file(self, async_client: AsyncSupermemory) -> None:
     async def test_method_upload_file_with_all_params(self, async_client: AsyncSupermemory) -> None:
         document = await async_client.documents.upload_file(
             file=b"Example data",
+            container_tag="user",
             container_tags='["user_123", "project_123"]',
             file_type="image",
             metadata='{"category": "technology", "isPublic": true, "readingTime": 5}',