feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev%2Fcontext.dev-3c753cf7c4d04fe467710a51b1a2f6f024b0b6a670704be7340b92e064bcf1a9.yml
-openapi_spec_hash: f9b02e6756001e2be87d541d5cc609e5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev%2Fcontext.dev-3a604b0c9775298072e70890d369d21d38422553a8fe23d9d081b0dc06035ee2.yml
+openapi_spec_hash: f94db2839851fb192f013b3ca258c39f
 config_hash: 85e90b8fda2e1f326ca60f8ab3e53704

src/context/dev/resources/brand.py

@@ -637,7 +637,6 @@ def identify_from_transaction(
 
           high_confidence_only: When set to true, the API will perform an additional verification steps to
               ensure the identified brand matches the transaction with high confidence.
-              Defaults to false.
 
           max_speed: Optional parameter to optimize the API call for maximum speed. When set to true,
               the API will skip time-consuming operations for faster response at the cost of
@@ -823,9 +822,8 @@ def retrieve_by_email(
     ) -> BrandRetrieveByEmailResponse:
         """
         Retrieve brand information using an email address while detecting disposable and
-        free email addresses. This endpoint extracts the domain from the email address
-        and returns brand data for that domain. Disposable and free email addresses
-        (like gmail.com, yahoo.com) will throw a 422 error.
+        free email addresses. Disposable and free email addresses (like gmail.com,
+        yahoo.com) will throw a 422 error.
 
         Args:
           email: Email address to retrieve brand data for (e.g., 'contact@example.com'). The
@@ -1008,8 +1006,7 @@ def retrieve_by_isin(
     ) -> BrandRetrieveByIsinResponse:
         """
         Retrieve brand information using an ISIN (International Securities
-        Identification Number). This endpoint looks up the company associated with the
-        ISIN and returns its brand data.
+        Identification Number).
 
         Args:
           isin: ISIN (International Securities Identification Number) to retrieve brand data for
@@ -1432,17 +1429,15 @@ def retrieve_by_name(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BrandRetrieveByNameResponse:
-        """Retrieve brand information using a company name.
-
-        This endpoint searches for the
-        company by name and returns its brand data.
+        """
+        Retrieve brand information using a company name.
 
         Args:
           name: Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft
               Corporation'). Must be 3-30 characters.
 
-          country_gl: Optional country code (GL parameter) to specify the country. This affects the
-              geographic location used for search queries.
+          country_gl: Optional country code hint (GL parameter) to specify the country for the company
+              name.
 
           force_language: Optional parameter to force the language of the retrieved brand data.
 
@@ -1694,10 +1689,8 @@ def retrieve_by_ticker(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BrandRetrieveByTickerResponse:
-        """Retrieve brand information using a stock ticker symbol.
-
-        This endpoint looks up
-        the company associated with the ticker and returns its brand data.
+        """
+        Retrieve brand information using a stock ticker symbol.
 
         Args:
           ticker: Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
@@ -1758,8 +1751,8 @@ def retrieve_simplified(
     ) -> BrandRetrieveSimplifiedResponse:
         """
         Returns a simplified version of brand data containing only essential
-        information: domain, title, colors, logos, and backdrops. This endpoint is
-        optimized for faster responses and reduced data transfer.
+        information: domain, title, colors, logos, and backdrops. Optimized for faster
+        responses and reduced data transfer.
 
         Args:
           domain: Domain name to retrieve simplified brand data for
@@ -2395,7 +2388,6 @@ async def identify_from_transaction(
 
           high_confidence_only: When set to true, the API will perform an additional verification steps to
               ensure the identified brand matches the transaction with high confidence.
-              Defaults to false.
 
           max_speed: Optional parameter to optimize the API call for maximum speed. When set to true,
               the API will skip time-consuming operations for faster response at the cost of
@@ -2581,9 +2573,8 @@ async def retrieve_by_email(
     ) -> BrandRetrieveByEmailResponse:
         """
         Retrieve brand information using an email address while detecting disposable and
-        free email addresses. This endpoint extracts the domain from the email address
-        and returns brand data for that domain. Disposable and free email addresses
-        (like gmail.com, yahoo.com) will throw a 422 error.
+        free email addresses. Disposable and free email addresses (like gmail.com,
+        yahoo.com) will throw a 422 error.
 
         Args:
           email: Email address to retrieve brand data for (e.g., 'contact@example.com'). The
@@ -2766,8 +2757,7 @@ async def retrieve_by_isin(
     ) -> BrandRetrieveByIsinResponse:
         """
         Retrieve brand information using an ISIN (International Securities
-        Identification Number). This endpoint looks up the company associated with the
-        ISIN and returns its brand data.
+        Identification Number).
 
         Args:
           isin: ISIN (International Securities Identification Number) to retrieve brand data for
@@ -3190,17 +3180,15 @@ async def retrieve_by_name(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BrandRetrieveByNameResponse:
-        """Retrieve brand information using a company name.
-
-        This endpoint searches for the
-        company by name and returns its brand data.
+        """
+        Retrieve brand information using a company name.
 
         Args:
           name: Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft
               Corporation'). Must be 3-30 characters.
 
-          country_gl: Optional country code (GL parameter) to specify the country. This affects the
-              geographic location used for search queries.
+          country_gl: Optional country code hint (GL parameter) to specify the country for the company
+              name.
 
           force_language: Optional parameter to force the language of the retrieved brand data.
 
@@ -3452,10 +3440,8 @@ async def retrieve_by_ticker(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BrandRetrieveByTickerResponse:
-        """Retrieve brand information using a stock ticker symbol.
-
-        This endpoint looks up
-        the company associated with the ticker and returns its brand data.
+        """
+        Retrieve brand information using a stock ticker symbol.
 
         Args:
           ticker: Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
@@ -3516,8 +3502,8 @@ async def retrieve_simplified(
     ) -> BrandRetrieveSimplifiedResponse:
         """
         Returns a simplified version of brand data containing only essential
-        information: domain, title, colors, logos, and backdrops. This endpoint is
-        optimized for faster responses and reduced data transfer.
+        information: domain, title, colors, logos, and backdrops. Optimized for faster
+        responses and reduced data transfer.
 
         Args:
           domain: Domain name to retrieve simplified brand data for

src/context/dev/resources/web.py

@@ -486,7 +486,7 @@ def web_scrape_sitemap(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebWebScrapeSitemapResponse:
         """
-        Crawl an entire website's sitemap and return all discovered page URLs
+        Crawl an entire website's sitemap and return all discovered page URLs.
 
         Args:
           domain: Domain to build a sitemap for
@@ -968,7 +968,7 @@ async def web_scrape_sitemap(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebWebScrapeSitemapResponse:
         """
-        Crawl an entire website's sitemap and return all discovered page URLs
+        Crawl an entire website's sitemap and return all discovered page URLs.
 
         Args:
           domain: Domain to build a sitemap for

src/context/dev/types/brand_identify_from_transaction_params.py

@@ -390,7 +390,6 @@ class BrandIdentifyFromTransactionParams(TypedDict, total=False):
     """
     When set to true, the API will perform an additional verification steps to
     ensure the identified brand matches the transaction with high confidence.
-    Defaults to false.
     """
 
     max_speed: Annotated[bool, PropertyInfo(alias="maxSpeed")]

src/context/dev/types/brand_retrieve_by_name_params.py

@@ -257,9 +257,9 @@ class BrandRetrieveByNameParams(TypedDict, total=False):
         "zm",
         "zw",
     ]
-    """Optional country code (GL parameter) to specify the country.
-
-    This affects the geographic location used for search queries.
+    """
+    Optional country code hint (GL parameter) to specify the country for the company
+    name.
     """
 
     force_language: Literal[