release: 0.17.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.16.0"
+  ".": "0.17.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 22
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-bfa54d26b675d92a0b3db3e3c2147dc98250fb1e4cb82bb6bd6f9af544763506.yml
-openapi_spec_hash: 7d834a5553262d0a2538bc066f39d549
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-44904c513baa439f294b23964ea368ad52863e13328980f9cac5a8e78cbb58cb.yml
+openapi_spec_hash: 9bb50ca838166fb474d28009a7edbd49
 config_hash: 70354330f92ce169beabc98696ebb9a3

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.17.0 (2026-05-06)
+
+Full Changelog: [v0.16.0...v0.17.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.16.0...v0.17.0)
+
+### Features
+
+* **api:** api update ([cd23fbc](https://github.com/context-dot-dev/context-python-sdk/commit/cd23fbc9f0b423246699f3cc78a9ce3b734f1acf))
+
 ## 0.16.0 (2026-05-06)
 
 Full Changelog: [v0.15.0...v0.16.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.15.0...v0.16.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "context.dev"
-version = "0.16.0"
+version = "0.17.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.16.0"  # x-release-please-version
+__version__ = "0.17.0"  # x-release-please-version

src/context/dev/types/brand_retrieve_by_email_params.py

@@ -141,6 +141,14 @@ class BrandRetrieveByEmailParams(TypedDict, total=False):
     ]
     """Optional parameter to force the language of the retrieved brand data."""
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    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
+    year.
+    """
+
     max_speed: Annotated[bool, PropertyInfo(alias="maxSpeed")]
     """Optional parameter to optimize the API call for maximum speed.
 

src/context/dev/types/brand_retrieve_by_isin_params.py

@@ -141,6 +141,14 @@ class BrandRetrieveByIsinParams(TypedDict, total=False):
     ]
     """Optional parameter to force the language of the retrieved brand data."""
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    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
+    year.
+    """
+
     max_speed: Annotated[bool, PropertyInfo(alias="maxSpeed")]
     """Optional parameter to optimize the API call for maximum speed.
 

src/context/dev/types/brand_retrieve_by_name_params.py

@@ -386,6 +386,14 @@ class BrandRetrieveByNameParams(TypedDict, total=False):
     ]
     """Optional parameter to force the language of the retrieved brand data."""
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    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
+    year.
+    """
+
     max_speed: Annotated[bool, PropertyInfo(alias="maxSpeed")]
     """Optional parameter to optimize the API call for maximum speed.
 

src/context/dev/types/brand_retrieve_by_ticker_params.py

@@ -140,6 +140,14 @@ class BrandRetrieveByTickerParams(TypedDict, total=False):
     ]
     """Optional parameter to force the language of the retrieved brand data."""
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    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
+    year.
+    """
+
     max_speed: Annotated[bool, PropertyInfo(alias="maxSpeed")]
     """Optional parameter to optimize the API call for maximum speed.
 

src/context/dev/types/brand_retrieve_params.py

@@ -140,6 +140,14 @@ class BrandRetrieveParams(TypedDict, total=False):
     ]
     """Optional parameter to force the language of the retrieved brand data."""
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    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
+    year.
+    """
+
     max_speed: Annotated[bool, PropertyInfo(alias="maxSpeed")]
     """Optional parameter to optimize the API call for maximum speed.
 

src/context/dev/types/brand_retrieve_simplified_params.py

@@ -13,6 +13,14 @@ class BrandRetrieveSimplifiedParams(TypedDict, total=False):
     domain: Required[str]
     """Domain name to retrieve simplified brand data for"""
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    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
+    year.
+    """
+
     timeout_ms: Annotated[int, PropertyInfo(alias="timeoutMS")]
     """Optional timeout in milliseconds for the request.
 

src/context/dev/types/web_web_scrape_images_params.py

@@ -42,7 +42,7 @@ class Enrichment(TypedDict, total=False):
     """
 
     max_time_per_ms: Annotated[int, PropertyInfo(alias="maxTimePerMs")]
-    """Per-image enrichment timeout in milliseconds. Default: 6000. Maximum: 60000."""
+    """Per-image enrichment timeout in milliseconds. Default: 30000. Maximum: 60000."""
 
     resolution: bool
     """Measure image width and height when possible."""

tests/api_resources/test_brand.py

@@ -39,6 +39,7 @@ def test_method_retrieve_with_all_params(self, client: ContextDev) -> None:
         brand = client.brand.retrieve(
             domain="domain",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             timeout_ms=1000,
         )
@@ -134,6 +135,7 @@ def test_method_retrieve_by_email_with_all_params(self, client: ContextDev) -> N
         brand = client.brand.retrieve_by_email(
             email="dev@stainless.com",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             timeout_ms=1000,
         )
@@ -179,6 +181,7 @@ def test_method_retrieve_by_isin_with_all_params(self, client: ContextDev) -> No
         brand = client.brand.retrieve_by_isin(
             isin="SE60513A9993",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             timeout_ms=1000,
         )
@@ -225,6 +228,7 @@ def test_method_retrieve_by_name_with_all_params(self, client: ContextDev) -> No
             name="xxx",
             country_gl="ad",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             timeout_ms=1000,
         )
@@ -270,6 +274,7 @@ def test_method_retrieve_by_ticker_with_all_params(self, client: ContextDev) ->
         brand = client.brand.retrieve_by_ticker(
             ticker="ticker",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             ticker_exchange="AMEX",
             timeout_ms=1000,
@@ -315,6 +320,7 @@ def test_method_retrieve_simplified(self, client: ContextDev) -> None:
     def test_method_retrieve_simplified_with_all_params(self, client: ContextDev) -> None:
         brand = client.brand.retrieve_simplified(
             domain="domain",
+            max_age_ms=86400000,
             timeout_ms=1000,
         )
         assert_matches_type(BrandRetrieveSimplifiedResponse, brand, path=["response"])
@@ -365,6 +371,7 @@ async def test_method_retrieve_with_all_params(self, async_client: AsyncContextD
         brand = await async_client.brand.retrieve(
             domain="domain",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             timeout_ms=1000,
         )
@@ -460,6 +467,7 @@ async def test_method_retrieve_by_email_with_all_params(self, async_client: Asyn
         brand = await async_client.brand.retrieve_by_email(
             email="dev@stainless.com",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             timeout_ms=1000,
         )
@@ -505,6 +513,7 @@ async def test_method_retrieve_by_isin_with_all_params(self, async_client: Async
         brand = await async_client.brand.retrieve_by_isin(
             isin="SE60513A9993",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             timeout_ms=1000,
         )
@@ -551,6 +560,7 @@ async def test_method_retrieve_by_name_with_all_params(self, async_client: Async
             name="xxx",
             country_gl="ad",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             timeout_ms=1000,
         )
@@ -596,6 +606,7 @@ async def test_method_retrieve_by_ticker_with_all_params(self, async_client: Asy
         brand = await async_client.brand.retrieve_by_ticker(
             ticker="ticker",
             force_language="afrikaans",
+            max_age_ms=86400000,
             max_speed=True,
             ticker_exchange="AMEX",
             timeout_ms=1000,
@@ -641,6 +652,7 @@ async def test_method_retrieve_simplified(self, async_client: AsyncContextDev) -
     async def test_method_retrieve_simplified_with_all_params(self, async_client: AsyncContextDev) -> None:
         brand = await async_client.brand.retrieve_simplified(
             domain="domain",
+            max_age_ms=86400000,
             timeout_ms=1000,
         )
         assert_matches_type(BrandRetrieveSimplifiedResponse, brand, path=["response"])