release: 0.26.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.25.0"
+  ".": "0.26.0"
 }

.stats.yml

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

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.26.0 (2026-05-30)
+
+Full Changelog: [v0.25.0...v0.26.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.25.0...v0.26.0)
+
+### Features
+
+* **api:** api update ([cd6cf45](https://github.com/context-dot-dev/context-python-sdk/commit/cd6cf45c0dbc402fa7c4d5b8625ec16b5ad35390))
+
 ## 0.25.0 (2026-05-19)
 
 Full Changelog: [v0.24.0...v0.25.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.24.0...v0.25.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "context.dev"
-version = "0.25.0"
+version = "0.26.0"
 description = "The official Python library for the context.dev API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/context/dev/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "context.dev"
-__version__ = "0.25.0"  # x-release-please-version
+__version__ = "0.26.0"  # x-release-please-version

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"])