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/hyperspell%2Fhyperspell-ee3e5367e2c30e5e66d7ef26a20b4d55dbe739a120a3465c48b9bbe106a28940.yml
-openapi_spec_hash: a017a75019d7cc692e9ca7d7c6fedd8e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hyperspell%2Fhyperspell-4066d19206db91d6b4e638e78240ed568844eb3065b073126f0161fc95c39adc.yml
+openapi_spec_hash: 13b1fddffd88cb50d29b54280f58e526
 config_hash: da009f16a6b9b4db17be2949180ace1e

src/hyperspell/resources/documents.py

@@ -156,6 +156,7 @@ def add(
         text: str,
         collection: Optional[str] | NotGiven = NOT_GIVEN,
         date: Union[str, datetime] | NotGiven = NOT_GIVEN,
+        resource_id: str | NotGiven = NOT_GIVEN,
         title: Optional[str] | 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.
@@ -180,6 +181,9 @@ def add(
               the date of the last message). This helps the ranking algorithm and allows you
               to filter by date range.
 
+          resource_id: The resource ID to add the document to. If not provided, a new resource ID will
+              be generated. If provided, the document will be updated if it already exists.
+
           title: Title of the document.
 
           extra_headers: Send extra headers
@@ -197,6 +201,7 @@ def add(
                     "text": text,
                     "collection": collection,
                     "date": date,
+                    "resource_id": resource_id,
                     "title": title,
                 },
                 document_add_params.DocumentAddParams,
@@ -493,6 +498,7 @@ async def add(
         text: str,
         collection: Optional[str] | NotGiven = NOT_GIVEN,
         date: Union[str, datetime] | NotGiven = NOT_GIVEN,
+        resource_id: str | NotGiven = NOT_GIVEN,
         title: Optional[str] | 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.
@@ -517,6 +523,9 @@ async def add(
               the date of the last message). This helps the ranking algorithm and allows you
               to filter by date range.
 
+          resource_id: The resource ID to add the document to. If not provided, a new resource ID will
+              be generated. If provided, the document will be updated if it already exists.
+
           title: Title of the document.
 
           extra_headers: Send extra headers
@@ -534,6 +543,7 @@ async def add(
                     "text": text,
                     "collection": collection,
                     "date": date,
+                    "resource_id": resource_id,
                     "title": title,
                 },
                 document_add_params.DocumentAddParams,

src/hyperspell/types/document_add_params.py

@@ -27,5 +27,12 @@ class DocumentAddParams(TypedDict, total=False):
     range.
     """
 
+    resource_id: str
+    """The resource ID to add the document to.
+
+    If not provided, a new resource ID will be generated. If provided, the document
+    will be updated if it already exists.
+    """
+
     title: Optional[str]
     """Title of the document."""

tests/api_resources/test_documents.py

@@ -71,6 +71,7 @@ def test_method_add_with_all_params(self, client: Hyperspell) -> None:
             text="text",
             collection="collection",
             date=parse_datetime("2019-12-27T18:11:19.117Z"),
+            resource_id="resource_id",
             title="title",
         )
         assert_matches_type(DocumentStatus, document, path=["response"])
@@ -257,6 +258,7 @@ async def test_method_add_with_all_params(self, async_client: AsyncHyperspell) -
             text="text",
             collection="collection",
             date=parse_datetime("2019-12-27T18:11:19.117Z"),
+            resource_id="resource_id",
             title="title",
         )
         assert_matches_type(DocumentStatus, document, path=["response"])