feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 16
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-1a2a84a9cc99c25a9d726bc9300a72871f9469e3ceacebd5e71fd37e87891318.yml
-openapi_spec_hash: e71e86a645bc47a86664080c8697b8db
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-09da5c3ffd6340714c6cb0068dc6b708becce683de2ea324d03f402cf5113b16.yml
+openapi_spec_hash: 7f6021bcb2388695b04edb0575904421
 config_hash: be10c837d5319a33f30809a3ec223caf

README.md

@@ -127,9 +127,7 @@ from supermemory import Supermemory
 client = Supermemory()
 
 try:
-    client.memories.add(
-        content="This is a detailed article about machine learning concepts...",
-    )
+    client.memories.add()
 except supermemory.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -172,9 +170,7 @@ client = Supermemory(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).memories.add(
-    content="This is a detailed article about machine learning concepts...",
-)
+client.with_options(max_retries=5).memories.add()
 ```
 
 ### Timeouts
@@ -197,9 +193,7 @@ client = Supermemory(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).memories.add(
-    content="This is a detailed article about machine learning concepts...",
-)
+client.with_options(timeout=5.0).memories.add()
 ```
 
 On timeout, an `APITimeoutError` is thrown.
@@ -240,9 +234,7 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from supermemory import Supermemory
 
 client = Supermemory()
-response = client.memories.with_raw_response.add(
-    content="This is a detailed article about machine learning concepts...",
-)
+response = client.memories.with_raw_response.add()
 print(response.headers.get('X-My-Header'))
 
 memory = response.parse()  # get the object that `memories.add()` would have returned
@@ -260,9 +252,7 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.memories.with_streaming_response.add(
-    content="This is a detailed article about machine learning concepts...",
-) as response:
+with client.memories.with_streaming_response.add() as response:
     print(response.headers.get("X-My-Header"))
 
     for line in response.iter_lines():

requirements-dev.lock

@@ -56,7 +56,7 @@ httpx==0.28.1
     # via httpx-aiohttp
     # via respx
     # via supermemory
-httpx-aiohttp==0.1.6
+httpx-aiohttp==0.1.8
     # via supermemory
 idna==3.4
     # via anyio

requirements.lock

@@ -43,7 +43,7 @@ httpcore==1.0.2
 httpx==0.28.1
     # via httpx-aiohttp
     # via supermemory
-httpx-aiohttp==0.1.6
+httpx-aiohttp==0.1.8
     # via supermemory
 idna==3.4
     # via anyio

src/supermemory/resources/memories.py

@@ -51,8 +51,8 @@ def update(
         self,
         id: str,
         *,
-        content: str,
         container_tags: List[str] | NotGiven = NOT_GIVEN,
+        content: str | NotGiven = NOT_GIVEN,
         custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool]] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -66,6 +66,9 @@ def update(
         Update a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
           content: The content to extract and process into a memory. This can be a URL to a
               website, a PDF, an image, or a video.
 
@@ -75,9 +78,6 @@ def update(
 
               We automatically detect the content type from the url's response format.
 
-          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
-              user, a project ID, or any other identifier you wish to use to group memories.
-
           custom_id: Optional custom ID of the memory. This could be an ID from your database that
               will uniquely identify this memory.
 
@@ -101,8 +101,8 @@ def update(
             f"/v3/memories/{id}",
             body=maybe_transform(
                 {
-                    "content": content,
                     "container_tags": container_tags,
+                    "content": content,
                     "custom_id": custom_id,
                     "metadata": metadata,
                 },
@@ -211,8 +211,8 @@ def delete(
     def add(
         self,
         *,
-        content: str,
         container_tags: List[str] | NotGiven = NOT_GIVEN,
+        content: str | NotGiven = NOT_GIVEN,
         custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool]] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -226,6 +226,9 @@ def add(
         Add a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
           content: The content to extract and process into a memory. This can be a URL to a
               website, a PDF, an image, or a video.
 
@@ -235,9 +238,6 @@ def add(
 
               We automatically detect the content type from the url's response format.
 
-          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
-              user, a project ID, or any other identifier you wish to use to group memories.
-
           custom_id: Optional custom ID of the memory. This could be an ID from your database that
               will uniquely identify this memory.
 
@@ -259,8 +259,8 @@ def add(
             "/v3/memories",
             body=maybe_transform(
                 {
-                    "content": content,
                     "container_tags": container_tags,
+                    "content": content,
                     "custom_id": custom_id,
                     "metadata": metadata,
                 },
@@ -330,8 +330,8 @@ async def update(
         self,
         id: str,
         *,
-        content: str,
         container_tags: List[str] | NotGiven = NOT_GIVEN,
+        content: str | NotGiven = NOT_GIVEN,
         custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool]] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -345,6 +345,9 @@ async def update(
         Update a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
           content: The content to extract and process into a memory. This can be a URL to a
               website, a PDF, an image, or a video.
 
@@ -354,9 +357,6 @@ async def update(
 
               We automatically detect the content type from the url's response format.
 
-          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
-              user, a project ID, or any other identifier you wish to use to group memories.
-
           custom_id: Optional custom ID of the memory. This could be an ID from your database that
               will uniquely identify this memory.
 
@@ -380,8 +380,8 @@ async def update(
             f"/v3/memories/{id}",
             body=await async_maybe_transform(
                 {
-                    "content": content,
                     "container_tags": container_tags,
+                    "content": content,
                     "custom_id": custom_id,
                     "metadata": metadata,
                 },
@@ -490,8 +490,8 @@ async def delete(
     async def add(
         self,
         *,
-        content: str,
         container_tags: List[str] | NotGiven = NOT_GIVEN,
+        content: str | NotGiven = NOT_GIVEN,
         custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool]] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -505,6 +505,9 @@ async def add(
         Add a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
           content: The content to extract and process into a memory. This can be a URL to a
               website, a PDF, an image, or a video.
 
@@ -514,9 +517,6 @@ async def add(
 
               We automatically detect the content type from the url's response format.
 
-          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
-              user, a project ID, or any other identifier you wish to use to group memories.
-
           custom_id: Optional custom ID of the memory. This could be an ID from your database that
               will uniquely identify this memory.
 
@@ -538,8 +538,8 @@ async def add(
             "/v3/memories",
             body=await async_maybe_transform(
                 {
-                    "content": content,
                     "container_tags": container_tags,
+                    "content": content,
                     "custom_id": custom_id,
                     "metadata": metadata,
                 },

src/supermemory/types/memory_add_params.py

@@ -3,15 +3,22 @@
 from __future__ import annotations
 
 from typing import Dict, List, Union
-from typing_extensions import Required, Annotated, TypedDict
+from typing_extensions import Annotated, TypedDict
 
 from .._utils import PropertyInfo
 
 __all__ = ["MemoryAddParams"]
 
 
 class MemoryAddParams(TypedDict, total=False):
-    content: Required[str]
+    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
+    """Optional tags this memory should be containerized by.
+
+    This can be an ID for your user, a project ID, or any other identifier you wish
+    to use to group memories.
+    """
+
+    content: str
     """The content to extract and process into a memory.
 
     This can be a URL to a website, a PDF, an image, or a video.
@@ -23,13 +30,6 @@ class MemoryAddParams(TypedDict, total=False):
     We automatically detect the content type from the url's response format.
     """
 
-    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
-    """Optional tags this memory should be containerized by.
-
-    This can be an ID for your user, a project ID, or any other identifier you wish
-    to use to group memories.
-    """
-
     custom_id: Annotated[str, PropertyInfo(alias="customId")]
     """Optional custom ID of the memory.
 

src/supermemory/types/memory_update_params.py

@@ -3,15 +3,22 @@
 from __future__ import annotations
 
 from typing import Dict, List, Union
-from typing_extensions import Required, Annotated, TypedDict
+from typing_extensions import Annotated, TypedDict
 
 from .._utils import PropertyInfo
 
 __all__ = ["MemoryUpdateParams"]
 
 
 class MemoryUpdateParams(TypedDict, total=False):
-    content: Required[str]
+    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
+    """Optional tags this memory should be containerized by.
+
+    This can be an ID for your user, a project ID, or any other identifier you wish
+    to use to group memories.
+    """
+
+    content: str
     """The content to extract and process into a memory.
 
     This can be a URL to a website, a PDF, an image, or a video.
@@ -23,13 +30,6 @@ class MemoryUpdateParams(TypedDict, total=False):
     We automatically detect the content type from the url's response format.
     """
 
-    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
-    """Optional tags this memory should be containerized by.
-
-    This can be an ID for your user, a project ID, or any other identifier you wish
-    to use to group memories.
-    """
-
     custom_id: Annotated[str, PropertyInfo(alias="customId")]
     """Optional custom ID of the memory.