feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 10
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-6620330945de41f1c453692af40842f08fe1fd281ff6ba4e79d447c941ebd783.yml
-openapi_spec_hash: 861a43669d27d942d4bd3e36a398e95b
-config_hash: a1303564edd6276a63d584a02b2238b2
+configured_endpoints: 11
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-03d0d129690a7e6178f207b283001e66c7ef4a74d340647f18ce21ca3ccd8a1a.yml
+openapi_spec_hash: f64086044d57f32cba3ead2151fb4d61
+config_hash: 083e432ea397a9018371145493400188

api.md

@@ -8,6 +8,7 @@ from brand.dev.types import (
     BrandAIQueryResponse,
     BrandIdentifyFromTransactionResponse,
     BrandPrefetchResponse,
+    BrandRetrieveByEmailResponse,
     BrandRetrieveByNameResponse,
     BrandRetrieveByTickerResponse,
     BrandRetrieveNaicsResponse,
@@ -23,6 +24,7 @@ Methods:
 - <code title="post /brand/ai/query">client.brand.<a href="./src/brand/dev/resources/brand.py">ai_query</a>(\*\*<a href="src/brand/dev/types/brand_ai_query_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_ai_query_response.py">BrandAIQueryResponse</a></code>
 - <code title="get /brand/transaction_identifier">client.brand.<a href="./src/brand/dev/resources/brand.py">identify_from_transaction</a>(\*\*<a href="src/brand/dev/types/brand_identify_from_transaction_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_identify_from_transaction_response.py">BrandIdentifyFromTransactionResponse</a></code>
 - <code title="post /brand/prefetch">client.brand.<a href="./src/brand/dev/resources/brand.py">prefetch</a>(\*\*<a href="src/brand/dev/types/brand_prefetch_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_prefetch_response.py">BrandPrefetchResponse</a></code>
+- <code title="get /brand/retrieve-by-email">client.brand.<a href="./src/brand/dev/resources/brand.py">retrieve_by_email</a>(\*\*<a href="src/brand/dev/types/brand_retrieve_by_email_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_retrieve_by_email_response.py">BrandRetrieveByEmailResponse</a></code>
 - <code title="get /brand/retrieve-by-name">client.brand.<a href="./src/brand/dev/resources/brand.py">retrieve_by_name</a>(\*\*<a href="src/brand/dev/types/brand_retrieve_by_name_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_retrieve_by_name_response.py">BrandRetrieveByNameResponse</a></code>
 - <code title="get /brand/retrieve-by-ticker">client.brand.<a href="./src/brand/dev/resources/brand.py">retrieve_by_ticker</a>(\*\*<a href="src/brand/dev/types/brand_retrieve_by_ticker_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_retrieve_by_ticker_response.py">BrandRetrieveByTickerResponse</a></code>
 - <code title="get /brand/naics">client.brand.<a href="./src/brand/dev/resources/brand.py">retrieve_naics</a>(\*\*<a href="src/brand/dev/types/brand_retrieve_naics_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_retrieve_naics_response.py">BrandRetrieveNaicsResponse</a></code>

src/brand/dev/resources/brand.py

@@ -15,6 +15,7 @@
     brand_styleguide_params,
     brand_retrieve_naics_params,
     brand_retrieve_by_name_params,
+    brand_retrieve_by_email_params,
     brand_retrieve_by_ticker_params,
     brand_retrieve_simplified_params,
     brand_identify_from_transaction_params,
@@ -37,6 +38,7 @@
 from ..types.brand_styleguide_response import BrandStyleguideResponse
 from ..types.brand_retrieve_naics_response import BrandRetrieveNaicsResponse
 from ..types.brand_retrieve_by_name_response import BrandRetrieveByNameResponse
+from ..types.brand_retrieve_by_email_response import BrandRetrieveByEmailResponse
 from ..types.brand_retrieve_by_ticker_response import BrandRetrieveByTickerResponse
 from ..types.brand_retrieve_simplified_response import BrandRetrieveSimplifiedResponse
 from ..types.brand_identify_from_transaction_response import BrandIdentifyFromTransactionResponse
@@ -396,6 +398,123 @@ def prefetch(
             cast_to=BrandPrefetchResponse,
         )
 
+    def retrieve_by_email(
+        self,
+        *,
+        email: str,
+        force_language: Literal[
+            "albanian",
+            "arabic",
+            "azeri",
+            "bengali",
+            "bulgarian",
+            "cebuano",
+            "croatian",
+            "czech",
+            "danish",
+            "dutch",
+            "english",
+            "estonian",
+            "farsi",
+            "finnish",
+            "french",
+            "german",
+            "hausa",
+            "hawaiian",
+            "hindi",
+            "hungarian",
+            "icelandic",
+            "indonesian",
+            "italian",
+            "kazakh",
+            "kyrgyz",
+            "latin",
+            "latvian",
+            "lithuanian",
+            "macedonian",
+            "mongolian",
+            "nepali",
+            "norwegian",
+            "pashto",
+            "pidgin",
+            "polish",
+            "portuguese",
+            "romanian",
+            "russian",
+            "serbian",
+            "slovak",
+            "slovene",
+            "somali",
+            "spanish",
+            "swahili",
+            "swedish",
+            "tagalog",
+            "turkish",
+            "ukrainian",
+            "urdu",
+            "uzbek",
+            "vietnamese",
+            "welsh",
+        ]
+        | Omit = omit,
+        max_speed: bool | Omit = omit,
+        timeout_ms: int | Omit = omit,
+        # 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> 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.
+
+        Args:
+          email: Email address to retrieve brand data for (e.g., 'contact@example.com'). The
+              domain will be extracted from the email. Free email providers (gmail.com,
+              yahoo.com, etc.) and disposable email addresses are not allowed.
+
+          force_language: Optional parameter to force the language of the retrieved brand data.
+
+          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
+              less comprehensive data.
+
+          timeout_ms: Optional timeout in milliseconds for the request. If the request takes longer
+              than this value, it will be aborted with a 408 status code. Maximum allowed
+              value is 300000ms (5 minutes).
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get(
+            "/brand/retrieve-by-email",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "email": email,
+                        "force_language": force_language,
+                        "max_speed": max_speed,
+                        "timeout_ms": timeout_ms,
+                    },
+                    brand_retrieve_by_email_params.BrandRetrieveByEmailParams,
+                ),
+            ),
+            cast_to=BrandRetrieveByEmailResponse,
+        )
+
     def retrieve_by_name(
         self,
         *,
@@ -1281,6 +1400,123 @@ async def prefetch(
             cast_to=BrandPrefetchResponse,
         )
 
+    async def retrieve_by_email(
+        self,
+        *,
+        email: str,
+        force_language: Literal[
+            "albanian",
+            "arabic",
+            "azeri",
+            "bengali",
+            "bulgarian",
+            "cebuano",
+            "croatian",
+            "czech",
+            "danish",
+            "dutch",
+            "english",
+            "estonian",
+            "farsi",
+            "finnish",
+            "french",
+            "german",
+            "hausa",
+            "hawaiian",
+            "hindi",
+            "hungarian",
+            "icelandic",
+            "indonesian",
+            "italian",
+            "kazakh",
+            "kyrgyz",
+            "latin",
+            "latvian",
+            "lithuanian",
+            "macedonian",
+            "mongolian",
+            "nepali",
+            "norwegian",
+            "pashto",
+            "pidgin",
+            "polish",
+            "portuguese",
+            "romanian",
+            "russian",
+            "serbian",
+            "slovak",
+            "slovene",
+            "somali",
+            "spanish",
+            "swahili",
+            "swedish",
+            "tagalog",
+            "turkish",
+            "ukrainian",
+            "urdu",
+            "uzbek",
+            "vietnamese",
+            "welsh",
+        ]
+        | Omit = omit,
+        max_speed: bool | Omit = omit,
+        timeout_ms: int | Omit = omit,
+        # 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> 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.
+
+        Args:
+          email: Email address to retrieve brand data for (e.g., 'contact@example.com'). The
+              domain will be extracted from the email. Free email providers (gmail.com,
+              yahoo.com, etc.) and disposable email addresses are not allowed.
+
+          force_language: Optional parameter to force the language of the retrieved brand data.
+
+          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
+              less comprehensive data.
+
+          timeout_ms: Optional timeout in milliseconds for the request. If the request takes longer
+              than this value, it will be aborted with a 408 status code. Maximum allowed
+              value is 300000ms (5 minutes).
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._get(
+            "/brand/retrieve-by-email",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "email": email,
+                        "force_language": force_language,
+                        "max_speed": max_speed,
+                        "timeout_ms": timeout_ms,
+                    },
+                    brand_retrieve_by_email_params.BrandRetrieveByEmailParams,
+                ),
+            ),
+            cast_to=BrandRetrieveByEmailResponse,
+        )
+
     async def retrieve_by_name(
         self,
         *,
@@ -1830,6 +2066,9 @@ def __init__(self, brand: BrandResource) -> None:
         self.prefetch = to_raw_response_wrapper(
             brand.prefetch,
         )
+        self.retrieve_by_email = to_raw_response_wrapper(
+            brand.retrieve_by_email,
+        )
         self.retrieve_by_name = to_raw_response_wrapper(
             brand.retrieve_by_name,
         )
@@ -1866,6 +2105,9 @@ def __init__(self, brand: AsyncBrandResource) -> None:
         self.prefetch = async_to_raw_response_wrapper(
             brand.prefetch,
         )
+        self.retrieve_by_email = async_to_raw_response_wrapper(
+            brand.retrieve_by_email,
+        )
         self.retrieve_by_name = async_to_raw_response_wrapper(
             brand.retrieve_by_name,
         )
@@ -1902,6 +2144,9 @@ def __init__(self, brand: BrandResource) -> None:
         self.prefetch = to_streamed_response_wrapper(
             brand.prefetch,
         )
+        self.retrieve_by_email = to_streamed_response_wrapper(
+            brand.retrieve_by_email,
+        )
         self.retrieve_by_name = to_streamed_response_wrapper(
             brand.retrieve_by_name,
         )
@@ -1938,6 +2183,9 @@ def __init__(self, brand: AsyncBrandResource) -> None:
         self.prefetch = async_to_streamed_response_wrapper(
             brand.prefetch,
         )
+        self.retrieve_by_email = async_to_streamed_response_wrapper(
+            brand.retrieve_by_email,
+        )
         self.retrieve_by_name = async_to_streamed_response_wrapper(
             brand.retrieve_by_name,
         )

src/brand/dev/types/__init__.py

@@ -15,8 +15,10 @@
 from .brand_retrieve_naics_params import BrandRetrieveNaicsParams as BrandRetrieveNaicsParams
 from .brand_retrieve_by_name_params import BrandRetrieveByNameParams as BrandRetrieveByNameParams
 from .brand_retrieve_naics_response import BrandRetrieveNaicsResponse as BrandRetrieveNaicsResponse
+from .brand_retrieve_by_email_params import BrandRetrieveByEmailParams as BrandRetrieveByEmailParams
 from .brand_retrieve_by_name_response import BrandRetrieveByNameResponse as BrandRetrieveByNameResponse
 from .brand_retrieve_by_ticker_params import BrandRetrieveByTickerParams as BrandRetrieveByTickerParams
+from .brand_retrieve_by_email_response import BrandRetrieveByEmailResponse as BrandRetrieveByEmailResponse
 from .brand_retrieve_simplified_params import BrandRetrieveSimplifiedParams as BrandRetrieveSimplifiedParams
 from .brand_retrieve_by_ticker_response import BrandRetrieveByTickerResponse as BrandRetrieveByTickerResponse
 from .brand_retrieve_simplified_response import BrandRetrieveSimplifiedResponse as BrandRetrieveSimplifiedResponse