feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-53441ebf037f11ab2656b64a88e11d78d4b92f39b803ba62fe3ccf77cb6f84eb.yml
-openapi_spec_hash: 88c222227b33b3cba5898fd55782cce9
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-079e4949baaeab93254aa8a651f4e9976e95387b1633002e925114ce36f29013.yml
+openapi_spec_hash: 331f27b62376aaf9c311af03a21d31b8
 config_hash: ada0970327c433e075b4ceef583e0755

src/context/dev/resources/web.py

@@ -66,6 +66,7 @@ def extract_fonts(
         *,
         direct_url: str | Omit = omit,
         domain: str | Omit = omit,
+        max_age_ms: int | 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.
@@ -87,6 +88,11 @@ def extract_fonts(
               domain will be automatically normalized and validated. You must provide either
               'domain' or 'directUrl', but not both.
 
+          max_age_ms: Maximum age in milliseconds for cached 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
+              year.
+
           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).
@@ -110,6 +116,7 @@ def extract_fonts(
                     {
                         "direct_url": direct_url,
                         "domain": domain,
+                        "max_age_ms": max_age_ms,
                         "timeout_ms": timeout_ms,
                     },
                     web_extract_fonts_params.WebExtractFontsParams,
@@ -123,6 +130,7 @@ def extract_styleguide(
         *,
         direct_url: str | Omit = omit,
         domain: str | Omit = omit,
+        max_age_ms: int | 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.
@@ -145,6 +153,11 @@ def extract_styleguide(
               domain will be automatically normalized and validated. You must provide either
               'domain' or 'directUrl', but not both.
 
+          max_age_ms: Maximum age in milliseconds for cached 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
+              year.
+
           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).
@@ -168,6 +181,7 @@ def extract_styleguide(
                     {
                         "direct_url": direct_url,
                         "domain": domain,
+                        "max_age_ms": max_age_ms,
                         "timeout_ms": timeout_ms,
                     },
                     web_extract_styleguide_params.WebExtractStyleguideParams,
@@ -749,6 +763,7 @@ async def extract_fonts(
         *,
         direct_url: str | Omit = omit,
         domain: str | Omit = omit,
+        max_age_ms: int | 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.
@@ -770,6 +785,11 @@ async def extract_fonts(
               domain will be automatically normalized and validated. You must provide either
               'domain' or 'directUrl', but not both.
 
+          max_age_ms: Maximum age in milliseconds for cached 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
+              year.
+
           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).
@@ -793,6 +813,7 @@ async def extract_fonts(
                     {
                         "direct_url": direct_url,
                         "domain": domain,
+                        "max_age_ms": max_age_ms,
                         "timeout_ms": timeout_ms,
                     },
                     web_extract_fonts_params.WebExtractFontsParams,
@@ -806,6 +827,7 @@ async def extract_styleguide(
         *,
         direct_url: str | Omit = omit,
         domain: str | Omit = omit,
+        max_age_ms: int | 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.
@@ -828,6 +850,11 @@ async def extract_styleguide(
               domain will be automatically normalized and validated. You must provide either
               'domain' or 'directUrl', but not both.
 
+          max_age_ms: Maximum age in milliseconds for cached 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
+              year.
+
           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).
@@ -851,6 +878,7 @@ async def extract_styleguide(
                     {
                         "direct_url": direct_url,
                         "domain": domain,
+                        "max_age_ms": max_age_ms,
                         "timeout_ms": timeout_ms,
                     },
                     web_extract_styleguide_params.WebExtractStyleguideParams,

src/context/dev/types/web_extract_fonts_params.py

@@ -24,6 +24,14 @@ class WebExtractFontsParams(TypedDict, total=False):
     either 'domain' or 'directUrl', but not both.
     """
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    Maximum age in milliseconds for cached 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
+    year.
+    """
+
     timeout_ms: Annotated[int, PropertyInfo(alias="timeoutMS")]
     """Optional timeout in milliseconds for the request.
 

src/context/dev/types/web_extract_styleguide_params.py

@@ -25,6 +25,14 @@ class WebExtractStyleguideParams(TypedDict, total=False):
     either 'domain' or 'directUrl', but not both.
     """
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    Maximum age in milliseconds for cached 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
+    year.
+    """
+
     timeout_ms: Annotated[int, PropertyInfo(alias="timeoutMS")]
     """Optional timeout in milliseconds for the request.
 

tests/api_resources/test_web.py

@@ -39,6 +39,7 @@ def test_method_extract_fonts_with_all_params(self, client: ContextDev) -> None:
         web = client.web.extract_fonts(
             direct_url="https://example.com",
             domain="domain",
+            max_age_ms=86400000,
             timeout_ms=1000,
         )
         assert_matches_type(WebExtractFontsResponse, web, path=["response"])
@@ -77,6 +78,7 @@ def test_method_extract_styleguide_with_all_params(self, client: ContextDev) ->
         web = client.web.extract_styleguide(
             direct_url="https://example.com",
             domain="domain",
+            max_age_ms=86400000,
             timeout_ms=1000,
         )
         assert_matches_type(WebExtractStyleguideResponse, web, path=["response"])
@@ -493,6 +495,7 @@ async def test_method_extract_fonts_with_all_params(self, async_client: AsyncCon
         web = await async_client.web.extract_fonts(
             direct_url="https://example.com",
             domain="domain",
+            max_age_ms=86400000,
             timeout_ms=1000,
         )
         assert_matches_type(WebExtractFontsResponse, web, path=["response"])
@@ -531,6 +534,7 @@ async def test_method_extract_styleguide_with_all_params(self, async_client: Asy
         web = await async_client.web.extract_styleguide(
             direct_url="https://example.com",
             domain="domain",
+            max_age_ms=86400000,
             timeout_ms=1000,
         )
         assert_matches_type(WebExtractStyleguideResponse, web, path=["response"])