feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 12
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-e6735b03c258b382c527550bb78042bdc3aad32a5cf564785dcb9f3fb13a2862.yml
-openapi_spec_hash: 8168fb51314d986893554e1cc935ca7d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-101f86a36ccd7f0652cfb6cac5d8f49e45ce3bee2b96692e8decd1eda3419604.yml
+openapi_spec_hash: b6c08c22ab103285c7ada4eff95cfd0a
 config_hash: 8477e3ee6fd596ab6ac911d052e4de79

api.md

@@ -6,7 +6,6 @@ Types:
 from supermemory.types import (
     MemoryUpdateResponse,
     MemoryListResponse,
-    MemoryDeleteResponse,
     MemoryAddResponse,
     MemoryGetResponse,
     MemoryUploadFileResponse,
@@ -15,9 +14,9 @@ from supermemory.types import (
 
 Methods:
 
-- <code title="patch /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">update</a>(id, \*\*<a href="src/supermemory/types/memory_update_params.py">params</a>) -> <a href="./src/supermemory/types/memory_update_response.py">MemoryUpdateResponse</a></code>
+- <code title="patch /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">update</a>(path_id, \*\*<a href="src/supermemory/types/memory_update_params.py">params</a>) -> <a href="./src/supermemory/types/memory_update_response.py">MemoryUpdateResponse</a></code>
 - <code title="get /v3/memories">client.memories.<a href="./src/supermemory/resources/memories.py">list</a>(\*\*<a href="src/supermemory/types/memory_list_params.py">params</a>) -> <a href="./src/supermemory/types/memory_list_response.py">MemoryListResponse</a></code>
-- <code title="delete /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">delete</a>(id) -> <a href="./src/supermemory/types/memory_delete_response.py">MemoryDeleteResponse</a></code>
+- <code title="delete /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">delete</a>(id) -> None</code>
 - <code title="post /v3/memories">client.memories.<a href="./src/supermemory/resources/memories.py">add</a>(\*\*<a href="src/supermemory/types/memory_add_params.py">params</a>) -> <a href="./src/supermemory/types/memory_add_response.py">MemoryAddResponse</a></code>
 - <code title="get /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">get</a>(id) -> <a href="./src/supermemory/types/memory_get_response.py">MemoryGetResponse</a></code>
 - <code title="post /v3/memories/file">client.memories.<a href="./src/supermemory/resources/memories.py">upload_file</a>(\*\*<a href="src/supermemory/types/memory_upload_file_params.py">params</a>) -> <a href="./src/supermemory/types/memory_upload_file_response.py">MemoryUploadFileResponse</a></code>

src/supermemory/resources/memories.py

@@ -8,7 +8,7 @@
 import httpx
 
 from ..types import memory_add_params, memory_list_params, memory_update_params, memory_upload_file_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven, FileTypes
+from .._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven, FileTypes
 from .._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -22,7 +22,6 @@
 from ..types.memory_add_response import MemoryAddResponse
 from ..types.memory_get_response import MemoryGetResponse
 from ..types.memory_list_response import MemoryListResponse
-from ..types.memory_delete_response import MemoryDeleteResponse
 from ..types.memory_update_response import MemoryUpdateResponse
 from ..types.memory_upload_file_response import MemoryUploadFileResponse
 
@@ -51,10 +50,12 @@ def with_streaming_response(self) -> MemoriesResourceWithStreamingResponse:
 
     def update(
         self,
-        id: str,
+        path_id: str,
         *,
+        body_id: str,
         content: str,
         container_tags: List[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.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -67,6 +68,29 @@ def update(
         Update a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          body_id: Unique identifier of the memory.
+
+          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.
+
+              Plaintext: Any plaintext format
+
+              URL: A URL to a website, PDF, image, or video
+
+              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.
+
+          metadata: Optional metadata for the memory. This is used to store additional information
+              about the memory. You can use this to store any additional information you need
+              about the memory. Metadata can be filtered through. Keys must be strings and are
+              case sensitive. Values can be strings, numbers, or booleans. You cannot nest
+              objects.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -75,14 +99,16 @@ def update(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not path_id:
+            raise ValueError(f"Expected a non-empty value for `path_id` but received {path_id!r}")
         return self._patch(
-            f"/v3/memories/{id}",
+            f"/v3/memories/{path_id}",
             body=maybe_transform(
                 {
+                    "body_id": body_id,
                     "content": content,
                     "container_tags": container_tags,
+                    "custom_id": custom_id,
                     "metadata": metadata,
                 },
                 memory_update_params.MemoryUpdateParams,
@@ -161,7 +187,7 @@ def delete(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> MemoryDeleteResponse:
+    ) -> None:
         """
         Delete a memory
 
@@ -176,19 +202,21 @@ def delete(
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._delete(
             f"/v3/memories/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MemoryDeleteResponse,
+            cast_to=NoneType,
         )
 
     def add(
         self,
         *,
         content: str,
         container_tags: List[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.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -201,6 +229,27 @@ def add(
         Add a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          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.
+
+              Plaintext: Any plaintext format
+
+              URL: A URL to a website, PDF, image, or video
+
+              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.
+
+          metadata: Optional metadata for the memory. This is used to store additional information
+              about the memory. You can use this to store any additional information you need
+              about the memory. Metadata can be filtered through. Keys must be strings and are
+              case sensitive. Values can be strings, numbers, or booleans. You cannot nest
+              objects.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -215,6 +264,7 @@ def add(
                 {
                     "content": content,
                     "container_tags": container_tags,
+                    "custom_id": custom_id,
                     "metadata": metadata,
                 },
                 memory_add_params.MemoryAddParams,
@@ -320,10 +370,12 @@ def with_streaming_response(self) -> AsyncMemoriesResourceWithStreamingResponse:
 
     async def update(
         self,
-        id: str,
+        path_id: str,
         *,
+        body_id: str,
         content: str,
         container_tags: List[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.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -336,6 +388,29 @@ async def update(
         Update a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          body_id: Unique identifier of the memory.
+
+          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.
+
+              Plaintext: Any plaintext format
+
+              URL: A URL to a website, PDF, image, or video
+
+              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.
+
+          metadata: Optional metadata for the memory. This is used to store additional information
+              about the memory. You can use this to store any additional information you need
+              about the memory. Metadata can be filtered through. Keys must be strings and are
+              case sensitive. Values can be strings, numbers, or booleans. You cannot nest
+              objects.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -344,14 +419,16 @@ async def update(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not path_id:
+            raise ValueError(f"Expected a non-empty value for `path_id` but received {path_id!r}")
         return await self._patch(
-            f"/v3/memories/{id}",
+            f"/v3/memories/{path_id}",
             body=await async_maybe_transform(
                 {
+                    "body_id": body_id,
                     "content": content,
                     "container_tags": container_tags,
+                    "custom_id": custom_id,
                     "metadata": metadata,
                 },
                 memory_update_params.MemoryUpdateParams,
@@ -430,7 +507,7 @@ async def delete(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> MemoryDeleteResponse:
+    ) -> None:
         """
         Delete a memory
 
@@ -445,19 +522,21 @@ async def delete(
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._delete(
             f"/v3/memories/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MemoryDeleteResponse,
+            cast_to=NoneType,
         )
 
     async def add(
         self,
         *,
         content: str,
         container_tags: List[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.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -470,6 +549,27 @@ async def add(
         Add a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          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.
+
+              Plaintext: Any plaintext format
+
+              URL: A URL to a website, PDF, image, or video
+
+              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.
+
+          metadata: Optional metadata for the memory. This is used to store additional information
+              about the memory. You can use this to store any additional information you need
+              about the memory. Metadata can be filtered through. Keys must be strings and are
+              case sensitive. Values can be strings, numbers, or booleans. You cannot nest
+              objects.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -484,6 +584,7 @@ async def add(
                 {
                     "content": content,
                     "container_tags": container_tags,
+                    "custom_id": custom_id,
                     "metadata": metadata,
                 },
                 memory_add_params.MemoryAddParams,

src/supermemory/types/__init__.py

@@ -12,7 +12,6 @@
 from .search_execute_params import SearchExecuteParams as SearchExecuteParams
 from .setting_update_params import SettingUpdateParams as SettingUpdateParams
 from .connection_list_params import ConnectionListParams as ConnectionListParams
-from .memory_delete_response import MemoryDeleteResponse as MemoryDeleteResponse
 from .memory_update_response import MemoryUpdateResponse as MemoryUpdateResponse
 from .connection_get_response import ConnectionGetResponse as ConnectionGetResponse
 from .search_execute_response import SearchExecuteResponse as SearchExecuteResponse

src/supermemory/types/memory_add_params.py

@@ -12,7 +12,35 @@
 
 class MemoryAddParams(TypedDict, total=False):
     content: Required[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.
+
+    Plaintext: Any plaintext format
+
+    URL: A URL to a website, PDF, image, or video
+
+    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.
+
+    This could be an ID from your database that will uniquely identify this memory.
+    """
 
     metadata: Dict[str, Union[str, float, bool]]
+    """Optional metadata for the memory.
+
+    This is used to store additional information about the memory. You can use this
+    to store any additional information you need about the memory. Metadata can be
+    filtered through. Keys must be strings and are case sensitive. Values can be
+    strings, numbers, or booleans. You cannot nest objects.
+    """