feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 29
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-5280c0f42603633a06d2404b120b98d0d9aa43256d13680bbdead7579a90452a.yml
-openapi_spec_hash: 34869d638c12bf076949bb7e050dd634
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-7dbd739a81e6aaf7fc7ef1858606e7d572d309af55082a66431d9292e655e66f.yml
+openapi_spec_hash: a6374d5d718a7bd9d3d54fb657e2bd9d
 config_hash: ff35e224e809656528c44163aa41bebd

README.md

@@ -43,6 +43,7 @@ client = ContextDev(
 
 brand = client.brand.retrieve(
     domain="REPLACE_ME",
+    type="by_domain",
 )
 print(brand.brand)
 ```
@@ -69,6 +70,7 @@ client = AsyncContextDev(
 async def main() -> None:
     brand = await client.brand.retrieve(
         domain="REPLACE_ME",
+        type="by_domain",
     )
     print(brand.brand)
 
@@ -105,6 +107,7 @@ async def main() -> None:
     ) as client:
         brand = await client.brand.retrieve(
             domain="REPLACE_ME",
+            type="by_domain",
         )
         print(brand.brand)
 
@@ -161,6 +164,7 @@ client = ContextDev()
 try:
     client.brand.retrieve(
         domain="REPLACE_ME",
+        type="by_domain",
     )
 except context.dev.APIConnectionError as e:
     print("The server could not be reached")
@@ -206,6 +210,7 @@ client = ContextDev(
 # Or, configure per-request:
 client.with_options(max_retries=5).brand.retrieve(
     domain="REPLACE_ME",
+    type="by_domain",
 )
 ```
 
@@ -231,6 +236,7 @@ client = ContextDev(
 # Override per-request:
 client.with_options(timeout=5.0).brand.retrieve(
     domain="REPLACE_ME",
+    type="by_domain",
 )
 ```
 
@@ -274,6 +280,7 @@ from context.dev import ContextDev
 client = ContextDev()
 response = client.brand.with_raw_response.retrieve(
     domain="REPLACE_ME",
+    type="by_domain",
 )
 print(response.headers.get('X-My-Header'))
 
@@ -294,6 +301,7 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 ```python
 with client.brand.with_streaming_response.retrieve(
     domain="REPLACE_ME",
+    type="by_domain",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

src/context/dev/resources/brand.py

@@ -49,6 +49,7 @@ def retrieve(
         self,
         *,
         domain: str,
+        type: Literal["by_domain"],
         force_language: Literal[
             "afrikaans",
             "albanian",
@@ -191,6 +192,8 @@ def retrieve(
         Args:
           domain: Domain name to retrieve brand data for (e.g., 'stripe.com').
 
+          type: Discriminator for domain-based brand retrieval.
+
           max_age_ms: Maximum age in milliseconds for cached brand data before the API performs a hard
               refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
               are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
@@ -219,6 +222,7 @@ def retrieve(
         self,
         *,
         name: str,
+        type: Literal["by_name"],
         country_gl: str | Omit = omit,
         force_language: Literal[
             "afrikaans",
@@ -362,6 +366,8 @@ def retrieve(
         Args:
           name: Company name to retrieve brand data for (e.g., 'Apple Inc').
 
+          type: Discriminator for name-based brand retrieval.
+
           country_gl: Optional country code hint (GL parameter) to specify the country when looking up
               by company name.
 
@@ -393,6 +399,7 @@ def retrieve(
         self,
         *,
         email: str,
+        type: Literal["by_email"],
         force_language: Literal[
             "afrikaans",
             "albanian",
@@ -535,6 +542,8 @@ def retrieve(
         Args:
           email: Email address to retrieve brand data for (e.g., 'jane@stripe.com').
 
+          type: Discriminator for email-based brand retrieval.
+
           max_age_ms: Maximum age in milliseconds for cached brand data before the API performs a hard
               refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
               are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
@@ -563,6 +572,7 @@ def retrieve(
         self,
         *,
         ticker: str,
+        type: Literal["by_ticker"],
         force_language: Literal[
             "afrikaans",
             "albanian",
@@ -706,6 +716,8 @@ def retrieve(
         Args:
           ticker: Stock ticker symbol to retrieve brand data for (e.g., 'AAPL').
 
+          type: Discriminator for ticker-based brand retrieval.
+
           max_age_ms: Maximum age in milliseconds for cached brand data before the API performs a hard
               refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
               are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
@@ -736,6 +748,7 @@ def retrieve(
         self,
         *,
         transaction_info: str,
+        type: Literal["by_transaction"],
         city: str | Omit = omit,
         country_gl: str | Omit = omit,
         force_language: Literal[
@@ -882,6 +895,8 @@ def retrieve(
         Args:
           transaction_info: Transaction information to identify the brand.
 
+          type: Discriminator for transaction-based brand retrieval.
+
           city: Optional city name to prioritize when searching for the brand.
 
           country_gl: Optional country code hint (GL parameter) to specify the country when
@@ -913,11 +928,18 @@ def retrieve(
         """
         ...
 
-    @required_args(["domain"], ["name"], ["email"], ["ticker"], ["transaction_info"])
+    @required_args(
+        ["domain", "type"], ["name", "type"], ["email", "type"], ["ticker", "type"], ["transaction_info", "type"]
+    )
     def retrieve(
         self,
         *,
         domain: str | Omit = omit,
+        type: Literal["by_domain"]
+        | Literal["by_name"]
+        | Literal["by_email"]
+        | Literal["by_ticker"]
+        | Literal["by_transaction"],
         force_language: Literal[
             "afrikaans",
             "albanian",
@@ -1066,6 +1088,7 @@ def retrieve(
             body=maybe_transform(
                 {
                     "domain": domain,
+                    "type": type,
                     "force_language": force_language,
                     "max_age_ms": max_age_ms,
                     "max_speed": max_speed,
@@ -1172,6 +1195,7 @@ async def retrieve(
         self,
         *,
         domain: str,
+        type: Literal["by_domain"],
         force_language: Literal[
             "afrikaans",
             "albanian",
@@ -1314,6 +1338,8 @@ async def retrieve(
         Args:
           domain: Domain name to retrieve brand data for (e.g., 'stripe.com').
 
+          type: Discriminator for domain-based brand retrieval.
+
           max_age_ms: Maximum age in milliseconds for cached brand data before the API performs a hard
               refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
               are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
@@ -1342,6 +1368,7 @@ async def retrieve(
         self,
         *,
         name: str,
+        type: Literal["by_name"],
         country_gl: str | Omit = omit,
         force_language: Literal[
             "afrikaans",
@@ -1485,6 +1512,8 @@ async def retrieve(
         Args:
           name: Company name to retrieve brand data for (e.g., 'Apple Inc').
 
+          type: Discriminator for name-based brand retrieval.
+
           country_gl: Optional country code hint (GL parameter) to specify the country when looking up
               by company name.
 
@@ -1516,6 +1545,7 @@ async def retrieve(
         self,
         *,
         email: str,
+        type: Literal["by_email"],
         force_language: Literal[
             "afrikaans",
             "albanian",
@@ -1658,6 +1688,8 @@ async def retrieve(
         Args:
           email: Email address to retrieve brand data for (e.g., 'jane@stripe.com').
 
+          type: Discriminator for email-based brand retrieval.
+
           max_age_ms: Maximum age in milliseconds for cached brand data before the API performs a hard
               refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
               are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
@@ -1686,6 +1718,7 @@ async def retrieve(
         self,
         *,
         ticker: str,
+        type: Literal["by_ticker"],
         force_language: Literal[
             "afrikaans",
             "albanian",
@@ -1829,6 +1862,8 @@ async def retrieve(
         Args:
           ticker: Stock ticker symbol to retrieve brand data for (e.g., 'AAPL').
 
+          type: Discriminator for ticker-based brand retrieval.
+
           max_age_ms: Maximum age in milliseconds for cached brand data before the API performs a hard
               refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
               are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
@@ -1859,6 +1894,7 @@ async def retrieve(
         self,
         *,
         transaction_info: str,
+        type: Literal["by_transaction"],
         city: str | Omit = omit,
         country_gl: str | Omit = omit,
         force_language: Literal[
@@ -2005,6 +2041,8 @@ async def retrieve(
         Args:
           transaction_info: Transaction information to identify the brand.
 
+          type: Discriminator for transaction-based brand retrieval.
+
           city: Optional city name to prioritize when searching for the brand.
 
           country_gl: Optional country code hint (GL parameter) to specify the country when
@@ -2036,11 +2074,18 @@ async def retrieve(
         """
         ...
 
-    @required_args(["domain"], ["name"], ["email"], ["ticker"], ["transaction_info"])
+    @required_args(
+        ["domain", "type"], ["name", "type"], ["email", "type"], ["ticker", "type"], ["transaction_info", "type"]
+    )
     async def retrieve(
         self,
         *,
         domain: str | Omit = omit,
+        type: Literal["by_domain"]
+        | Literal["by_name"]
+        | Literal["by_email"]
+        | Literal["by_ticker"]
+        | Literal["by_transaction"],
         force_language: Literal[
             "afrikaans",
             "albanian",
@@ -2189,6 +2234,7 @@ async def retrieve(
             body=await async_maybe_transform(
                 {
                     "domain": domain,
+                    "type": type,
                     "force_language": force_language,
                     "max_age_ms": max_age_ms,
                     "max_speed": max_speed,

src/context/dev/types/brand_retrieve_params.py

@@ -21,6 +21,9 @@ class BrandRetrieveByDomainRequest(TypedDict, total=False):
     domain: Required[str]
     """Domain name to retrieve brand data for (e.g., 'stripe.com')."""
 
+    type: Required[Literal["by_domain"]]
+    """Discriminator for domain-based brand retrieval."""
+
     force_language: Literal[
         "afrikaans",
         "albanian",
@@ -171,6 +174,9 @@ class BrandRetrieveByNameRequest(TypedDict, total=False):
     name: Required[str]
     """Company name to retrieve brand data for (e.g., 'Apple Inc')."""
 
+    type: Required[Literal["by_name"]]
+    """Discriminator for name-based brand retrieval."""
+
     country_gl: str
     """
     Optional country code hint (GL parameter) to specify the country when looking up
@@ -327,6 +333,9 @@ class BrandRetrieveByEmailRequest(TypedDict, total=False):
     email: Required[str]
     """Email address to retrieve brand data for (e.g., 'jane@stripe.com')."""
 
+    type: Required[Literal["by_email"]]
+    """Discriminator for email-based brand retrieval."""
+
     force_language: Literal[
         "afrikaans",
         "albanian",
@@ -477,6 +486,9 @@ class BrandRetrieveByTickerRequest(TypedDict, total=False):
     ticker: Required[str]
     """Stock ticker symbol to retrieve brand data for (e.g., 'AAPL')."""
 
+    type: Required[Literal["by_ticker"]]
+    """Discriminator for ticker-based brand retrieval."""
+
     force_language: Literal[
         "afrikaans",
         "albanian",
@@ -630,6 +642,9 @@ class BrandRetrieveFromTransactionRequest(TypedDict, total=False):
     transaction_info: Required[str]
     """Transaction information to identify the brand."""
 
+    type: Required[Literal["by_transaction"]]
+    """Discriminator for transaction-based brand retrieval."""
+
     city: str
     """Optional city name to prioritize when searching for the brand."""