feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 18
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-b7bf8402df5372a3fac3cb55e083d7c09867328639cb7e2ceb7826de125ccff7.yml
 openapi_spec_hash: a91c06034ad9e8a7315927d6f2e18521
-config_hash: 2737bce9823a13e0263c0fa2701821fa
+config_hash: 5deef1e3a49e3a7816348fbf7ba259bf

README.md

@@ -160,8 +160,8 @@ from supermemory import Supermemory
 client = Supermemory()
 
 try:
-    client.memories.update(
-        id="id",
+    client.memories.add(
+        content="This is a detailed article about machine learning concepts...",
     )
 except supermemory.APIConnectionError as e:
     print("The server could not be reached")
@@ -205,8 +205,8 @@ client = Supermemory(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).memories.update(
-    id="id",
+client.with_options(max_retries=5).memories.add(
+    content="This is a detailed article about machine learning concepts...",
 )
 ```
 
@@ -230,8 +230,8 @@ client = Supermemory(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).memories.update(
-    id="id",
+client.with_options(timeout=5.0).memories.add(
+    content="This is a detailed article about machine learning concepts...",
 )
 ```
 
@@ -273,12 +273,12 @@ 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.update(
-    id="id",
+response = client.memories.with_raw_response.add(
+    content="This is a detailed article about machine learning concepts...",
 )
 print(response.headers.get('X-My-Header'))
 
-memory = response.parse()  # get the object that `memories.update()` would have returned
+memory = response.parse()  # get the object that `memories.add()` would have returned
 print(memory.id)
 ```
 
@@ -293,8 +293,8 @@ 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.update(
-    id="id",
+with client.memories.with_streaming_response.add(
+    content="This is a detailed article about machine learning concepts...",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

tests/test_client.py

@@ -724,20 +724,24 @@ def test_parse_retry_after_header(self, remaining_retries: int, retry_after: str
     @mock.patch("supermemory._base_client.BaseClient._calculate_retry_timeout", _low_retry_timeout)
     @pytest.mark.respx(base_url=base_url)
     def test_retrying_timeout_errors_doesnt_leak(self, respx_mock: MockRouter, client: Supermemory) -> None:
-        respx_mock.patch("/v3/documents/id").mock(side_effect=httpx.TimeoutException("Test timeout error"))
+        respx_mock.post("/v3/documents").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
-            client.memories.with_streaming_response.update(id="id").__enter__()
+            client.memories.with_streaming_response.add(
+                content="This is a detailed article about machine learning concepts..."
+            ).__enter__()
 
         assert _get_open_connections(self.client) == 0
 
     @mock.patch("supermemory._base_client.BaseClient._calculate_retry_timeout", _low_retry_timeout)
     @pytest.mark.respx(base_url=base_url)
     def test_retrying_status_errors_doesnt_leak(self, respx_mock: MockRouter, client: Supermemory) -> None:
-        respx_mock.patch("/v3/documents/id").mock(return_value=httpx.Response(500))
+        respx_mock.post("/v3/documents").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
-            client.memories.with_streaming_response.update(id="id").__enter__()
+            client.memories.with_streaming_response.add(
+                content="This is a detailed article about machine learning concepts..."
+            ).__enter__()
         assert _get_open_connections(self.client) == 0
 
     @pytest.mark.parametrize("failures_before_success", [0, 2, 4])
@@ -764,9 +768,11 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.patch("/v3/documents/id").mock(side_effect=retry_handler)
+        respx_mock.post("/v3/documents").mock(side_effect=retry_handler)
 
-        response = client.memories.with_raw_response.update(id="id")
+        response = client.memories.with_raw_response.add(
+            content="This is a detailed article about machine learning concepts..."
+        )
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -788,9 +794,12 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.patch("/v3/documents/id").mock(side_effect=retry_handler)
+        respx_mock.post("/v3/documents").mock(side_effect=retry_handler)
 
-        response = client.memories.with_raw_response.update(id="id", extra_headers={"x-stainless-retry-count": Omit()})
+        response = client.memories.with_raw_response.add(
+            content="This is a detailed article about machine learning concepts...",
+            extra_headers={"x-stainless-retry-count": Omit()},
+        )
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
 
@@ -811,9 +820,12 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.patch("/v3/documents/id").mock(side_effect=retry_handler)
+        respx_mock.post("/v3/documents").mock(side_effect=retry_handler)
 
-        response = client.memories.with_raw_response.update(id="id", extra_headers={"x-stainless-retry-count": "42"})
+        response = client.memories.with_raw_response.add(
+            content="This is a detailed article about machine learning concepts...",
+            extra_headers={"x-stainless-retry-count": "42"},
+        )
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"
 
@@ -1541,10 +1553,12 @@ async def test_parse_retry_after_header(self, remaining_retries: int, retry_afte
     async def test_retrying_timeout_errors_doesnt_leak(
         self, respx_mock: MockRouter, async_client: AsyncSupermemory
     ) -> None:
-        respx_mock.patch("/v3/documents/id").mock(side_effect=httpx.TimeoutException("Test timeout error"))
+        respx_mock.post("/v3/documents").mock(side_effect=httpx.TimeoutException("Test timeout error"))
 
         with pytest.raises(APITimeoutError):
-            await async_client.memories.with_streaming_response.update(id="id").__aenter__()
+            await async_client.memories.with_streaming_response.add(
+                content="This is a detailed article about machine learning concepts..."
+            ).__aenter__()
 
         assert _get_open_connections(self.client) == 0
 
@@ -1553,10 +1567,12 @@ async def test_retrying_timeout_errors_doesnt_leak(
     async def test_retrying_status_errors_doesnt_leak(
         self, respx_mock: MockRouter, async_client: AsyncSupermemory
     ) -> None:
-        respx_mock.patch("/v3/documents/id").mock(return_value=httpx.Response(500))
+        respx_mock.post("/v3/documents").mock(return_value=httpx.Response(500))
 
         with pytest.raises(APIStatusError):
-            await async_client.memories.with_streaming_response.update(id="id").__aenter__()
+            await async_client.memories.with_streaming_response.add(
+                content="This is a detailed article about machine learning concepts..."
+            ).__aenter__()
         assert _get_open_connections(self.client) == 0
 
     @pytest.mark.parametrize("failures_before_success", [0, 2, 4])
@@ -1584,9 +1600,11 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.patch("/v3/documents/id").mock(side_effect=retry_handler)
+        respx_mock.post("/v3/documents").mock(side_effect=retry_handler)
 
-        response = await client.memories.with_raw_response.update(id="id")
+        response = await client.memories.with_raw_response.add(
+            content="This is a detailed article about machine learning concepts..."
+        )
 
         assert response.retries_taken == failures_before_success
         assert int(response.http_request.headers.get("x-stainless-retry-count")) == failures_before_success
@@ -1609,10 +1627,11 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.patch("/v3/documents/id").mock(side_effect=retry_handler)
+        respx_mock.post("/v3/documents").mock(side_effect=retry_handler)
 
-        response = await client.memories.with_raw_response.update(
-            id="id", extra_headers={"x-stainless-retry-count": Omit()}
+        response = await client.memories.with_raw_response.add(
+            content="This is a detailed article about machine learning concepts...",
+            extra_headers={"x-stainless-retry-count": Omit()},
         )
 
         assert len(response.http_request.headers.get_list("x-stainless-retry-count")) == 0
@@ -1635,10 +1654,11 @@ def retry_handler(_request: httpx.Request) -> httpx.Response:
                 return httpx.Response(500)
             return httpx.Response(200)
 
-        respx_mock.patch("/v3/documents/id").mock(side_effect=retry_handler)
+        respx_mock.post("/v3/documents").mock(side_effect=retry_handler)
 
-        response = await client.memories.with_raw_response.update(
-            id="id", extra_headers={"x-stainless-retry-count": "42"}
+        response = await client.memories.with_raw_response.add(
+            content="This is a detailed article about machine learning concepts...",
+            extra_headers={"x-stainless-retry-count": "42"},
         )
 
         assert response.http_request.headers.get("x-stainless-retry-count") == "42"