release: 2.1.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "2.0.0"
+  ".": "2.1.0"
 }

.stats.yml

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

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 2.1.0 (2026-07-08)
+
+Full Changelog: [v2.0.0...v2.1.0](https://github.com/context-dot-dev/context-python-sdk/compare/v2.0.0...v2.1.0)
+
+### Features
+
+* **api:** api update ([a72ac3e](https://github.com/context-dot-dev/context-python-sdk/commit/a72ac3e859ada135b723a985fd9e79696a5389de))
+* **api:** api update ([b34463f](https://github.com/context-dot-dev/context-python-sdk/commit/b34463f5a6d2d48511bb83b07517843643eb6994))
+* **api:** api update ([964c4b0](https://github.com/context-dot-dev/context-python-sdk/commit/964c4b09c0b9a2fc91e970e2a9c3e89c26f135c6))
+* **api:** api update ([fa060eb](https://github.com/context-dot-dev/context-python-sdk/commit/fa060eb4af5f793ea68661e8e8ec759e77cf4729))
+
 ## 2.0.0 (2026-07-06)
 
 Full Changelog: [v1.3.0...v2.0.0](https://github.com/context-dot-dev/context-python-sdk/compare/v1.3.0...v2.0.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "context.dev"
-version = "2.0.0"
+version = "2.1.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__ = "2.0.0"  # x-release-please-version
+__version__ = "2.1.0"  # x-release-please-version

src/context/dev/resources/brand.py

@@ -187,7 +187,9 @@ def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           domain: Domain name to retrieve brand data for (e.g., 'stripe.com').
@@ -361,7 +363,9 @@ def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           name: Company name to retrieve brand data for (e.g., 'Apple Inc').
@@ -537,7 +541,9 @@ def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           email: Email address to retrieve brand data for (e.g., 'jane@stripe.com').
@@ -711,7 +717,9 @@ def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           ticker: Stock ticker symbol to retrieve brand data for (e.g., 'AAPL').
@@ -743,6 +751,49 @@ def retrieve(
         """
         ...
 
+    @overload
+    def retrieve(
+        self,
+        *,
+        direct_url: str,
+        type: Literal["by_direct_url"],
+        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,
+    ) -> BrandRetrieveResponse:
+        """Retrieve logos, backdrops, colors, industry, description, and more.
+
+        Provide
+        exactly one lookup identifier in the request body: a domain, company name, email
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
+
+        Args:
+          direct_url: Full http(s) URL to fetch brand data from (e.g.,
+              'https://stripe.com/enterprise'). Only this URL is fetched — not the entire
+              internet.
+
+          type: Discriminator for direct-URL-based brand retrieval.
+
+          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
+        """
+        ...
+
     @overload
     def retrieve(
         self,
@@ -890,7 +941,9 @@ def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           transaction_info: Transaction information to identify the brand.
@@ -929,7 +982,12 @@ def retrieve(
         ...
 
     @required_args(
-        ["domain", "type"], ["name", "type"], ["email", "type"], ["ticker", "type"], ["transaction_info", "type"]
+        ["domain", "type"],
+        ["name", "type"],
+        ["email", "type"],
+        ["ticker", "type"],
+        ["direct_url", "type"],
+        ["transaction_info", "type"],
     )
     def retrieve(
         self,
@@ -939,6 +997,7 @@ def retrieve(
         | Literal["by_name"]
         | Literal["by_email"]
         | Literal["by_ticker"]
+        | Literal["by_direct_url"]
         | Literal["by_transaction"],
         force_language: Literal[
             "afrikaans",
@@ -1071,6 +1130,7 @@ def retrieve(
         email: str | Omit = omit,
         ticker: str | Omit = omit,
         ticker_exchange: str | Omit = omit,
+        direct_url: str | Omit = omit,
         transaction_info: str | Omit = omit,
         city: str | Omit = omit,
         high_confidence_only: bool | Omit = omit,
@@ -1098,6 +1158,7 @@ def retrieve(
                     "email": email,
                     "ticker": ticker,
                     "ticker_exchange": ticker_exchange,
+                    "direct_url": direct_url,
                     "transaction_info": transaction_info,
                     "city": city,
                     "high_confidence_only": high_confidence_only,
@@ -1333,7 +1394,9 @@ async def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           domain: Domain name to retrieve brand data for (e.g., 'stripe.com').
@@ -1507,7 +1570,9 @@ async def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           name: Company name to retrieve brand data for (e.g., 'Apple Inc').
@@ -1683,7 +1748,9 @@ async def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           email: Email address to retrieve brand data for (e.g., 'jane@stripe.com').
@@ -1857,7 +1924,9 @@ async def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           ticker: Stock ticker symbol to retrieve brand data for (e.g., 'AAPL').
@@ -1889,6 +1958,49 @@ async def retrieve(
         """
         ...
 
+    @overload
+    async def retrieve(
+        self,
+        *,
+        direct_url: str,
+        type: Literal["by_direct_url"],
+        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,
+    ) -> BrandRetrieveResponse:
+        """Retrieve logos, backdrops, colors, industry, description, and more.
+
+        Provide
+        exactly one lookup identifier in the request body: a domain, company name, email
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
+
+        Args:
+          direct_url: Full http(s) URL to fetch brand data from (e.g.,
+              'https://stripe.com/enterprise'). Only this URL is fetched — not the entire
+              internet.
+
+          type: Discriminator for direct-URL-based brand retrieval.
+
+          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
+        """
+        ...
+
     @overload
     async def retrieve(
         self,
@@ -2036,7 +2148,9 @@ async def retrieve(
 
         Provide
         exactly one lookup identifier in the request body: a domain, company name, email
-        address, stock ticker, or transaction descriptor.
+        address, stock ticker, transaction descriptor, or direct URL. Note:
+        `by_direct_url` fetches brand data only from the provided URL — not from the
+        entire internet.
 
         Args:
           transaction_info: Transaction information to identify the brand.
@@ -2075,7 +2189,12 @@ async def retrieve(
         ...
 
     @required_args(
-        ["domain", "type"], ["name", "type"], ["email", "type"], ["ticker", "type"], ["transaction_info", "type"]
+        ["domain", "type"],
+        ["name", "type"],
+        ["email", "type"],
+        ["ticker", "type"],
+        ["direct_url", "type"],
+        ["transaction_info", "type"],
     )
     async def retrieve(
         self,
@@ -2085,6 +2204,7 @@ async def retrieve(
         | Literal["by_name"]
         | Literal["by_email"]
         | Literal["by_ticker"]
+        | Literal["by_direct_url"]
         | Literal["by_transaction"],
         force_language: Literal[
             "afrikaans",
@@ -2217,6 +2337,7 @@ async def retrieve(
         email: str | Omit = omit,
         ticker: str | Omit = omit,
         ticker_exchange: str | Omit = omit,
+        direct_url: str | Omit = omit,
         transaction_info: str | Omit = omit,
         city: str | Omit = omit,
         high_confidence_only: bool | Omit = omit,
@@ -2244,6 +2365,7 @@ async def retrieve(
                     "email": email,
                     "ticker": ticker,
                     "ticker_exchange": ticker_exchange,
+                    "direct_url": direct_url,
                     "transaction_info": transaction_info,
                     "city": city,
                     "high_confidence_only": high_confidence_only,

src/context/dev/resources/monitors.py

@@ -239,7 +239,7 @@ def list(
         cursor: str | Omit = omit,
         limit: int | Omit = omit,
         q: str | Omit = omit,
-        search_by: List[Literal["name", "url", "query", "tags"]] | Omit = omit,
+        search_by: List[Literal["name", "url", "instructions", "tags"]] | Omit = omit,
         search_type: Literal["exact", "prefix"] | Omit = omit,
         status: Literal["active", "paused", "failed"] | Omit = omit,
         tag: str | Omit = omit,
@@ -261,8 +261,8 @@ def list(
         Args:
           q: Free-text search term, matched against the fields named in `search_by`.
 
-          search_by: Comma-separated fields to search with `q`. Defaults to all of them. Note `query`
-              only exists on semantic monitors.
+          search_by: Comma-separated fields to search with `q`. Defaults to all of them. Note
+              `instructions` only exists on extract monitors.
 
           search_type: `prefix` for as-you-type prefix matching (default), `exact` for full-token
               matching.
@@ -816,7 +816,7 @@ async def list(
         cursor: str | Omit = omit,
         limit: int | Omit = omit,
         q: str | Omit = omit,
-        search_by: List[Literal["name", "url", "query", "tags"]] | Omit = omit,
+        search_by: List[Literal["name", "url", "instructions", "tags"]] | Omit = omit,
         search_type: Literal["exact", "prefix"] | Omit = omit,
         status: Literal["active", "paused", "failed"] | Omit = omit,
         tag: str | Omit = omit,
@@ -838,8 +838,8 @@ async def list(
         Args:
           q: Free-text search term, matched against the fields named in `search_by`.
 
-          search_by: Comma-separated fields to search with `q`. Defaults to all of them. Note `query`
-              only exists on semantic monitors.
+          search_by: Comma-separated fields to search with `q`. Defaults to all of them. Note
+              `instructions` only exists on extract monitors.
 
           search_type: `prefix` for as-you-type prefix matching (default), `exact` for full-token
               matching.