context.dev 1.36.0 → 2.1.0

data/lib/context_dev/resources/brand.rb

@@ -3,23 +3,15 @@
 module ContextDev
   module Resources
     class Brand
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::BrandRetrieveParams} for more details.
-      #
-      # Retrieve logos, backdrops, colors, industry, description, and more from any
-      # domain
-      #
-      # @overload retrieve(domain:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
-      #
-      # @param domain [String] Domain name to retrieve brand data for (e.g., 'example.com', 'google.com'). Cann
+      # 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.
       #
-      # @param force_language [Symbol, ContextDev::Models::BrandRetrieveParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
+      # @overload retrieve(body:, request_options: {})
       #
-      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
-      #
-      # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
-      #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      # @param body [ContextDev::Models::BrandRetrieveParams::Body::ByDomain, ContextDev::Models::BrandRetrieveParams::Body::ByName, ContextDev::Models::BrandRetrieveParams::Body::ByEmail, ContextDev::Models::BrandRetrieveParams::Body::ByTicker, ContextDev::Models::BrandRetrieveParams::Body::ByDirectURL, ContextDev::Models::BrandRetrieveParams::Body::ByTransaction] Exactly one lookup type must be provided.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -28,202 +20,15 @@ module ContextDev
       # @see ContextDev::Models::BrandRetrieveParams
       def retrieve(params)
         parsed, options = ContextDev::BrandRetrieveParams.dump_request(params)
-        query = ContextDev::Internal::Util.encode_query_params(parsed)
         @client.request(
-          method: :get,
+          method: :post,
           path: "brand/retrieve",
-          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
+          body: parsed[:body],
           model: ContextDev::Models::BrandRetrieveResponse,
           options: options
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::BrandIdentifyFromTransactionParams} for more details.
-      #
-      # Endpoint specially designed for platforms that want to identify transaction data
-      # by the transaction title.
-      #
-      # @overload identify_from_transaction(transaction_info:, city: nil, country_gl: nil, force_language: nil, high_confidence_only: nil, max_speed: nil, mcc: nil, phone: nil, timeout_ms: nil, request_options: {})
-      #
-      # @param transaction_info [String] Transaction information to identify the brand
-      #
-      # @param city [String] Optional city name to prioritize when searching for the brand.
-      #
-      # @param country_gl [Symbol, ContextDev::Models::BrandIdentifyFromTransactionParams::CountryGl] Optional country code (GL parameter) to specify the country. This affects the ge
-      #
-      # @param force_language [Symbol, ContextDev::Models::BrandIdentifyFromTransactionParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
-      #
-      # @param high_confidence_only [Boolean] When set to true, the API will perform an additional verification steps to ensur
-      #
-      # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
-      #
-      # @param mcc [String] Optional Merchant Category Code (MCC) to help identify the business category/ind
-      #
-      # @param phone [Float] Optional phone number from the transaction to help verify brand match.
-      #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
-      #
-      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ContextDev::Models::BrandIdentifyFromTransactionResponse]
-      #
-      # @see ContextDev::Models::BrandIdentifyFromTransactionParams
-      def identify_from_transaction(params)
-        parsed, options = ContextDev::BrandIdentifyFromTransactionParams.dump_request(params)
-        query = ContextDev::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "brand/transaction_identifier",
-          query: query.transform_keys(max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
-          model: ContextDev::Models::BrandIdentifyFromTransactionResponse,
-          options: options
-        )
-      end
-
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::BrandRetrieveByEmailParams} for more details.
-      #
-      # Retrieve brand information using an email address while detecting disposable and
-      # free email addresses. Disposable and free email addresses (like gmail.com,
-      # yahoo.com) will throw a 422 error.
-      #
-      # @overload retrieve_by_email(email:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
-      #
-      # @param email [String] Email address to retrieve brand data for (e.g., 'contact@example.com'). The doma
-      #
-      # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByEmailParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
-      #
-      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
-      #
-      # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
-      #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
-      #
-      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ContextDev::Models::BrandRetrieveByEmailResponse]
-      #
-      # @see ContextDev::Models::BrandRetrieveByEmailParams
-      def retrieve_by_email(params)
-        parsed, options = ContextDev::BrandRetrieveByEmailParams.dump_request(params)
-        query = ContextDev::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "brand/retrieve-by-email",
-          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
-          model: ContextDev::Models::BrandRetrieveByEmailResponse,
-          options: options
-        )
-      end
-
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::BrandRetrieveByIsinParams} for more details.
-      #
-      # Retrieve brand information using an ISIN (International Securities
-      # Identification Number).
-      #
-      # @overload retrieve_by_isin(isin:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
-      #
-      # @param isin [String] ISIN (International Securities Identification Number) to retrieve brand data for
-      #
-      # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByIsinParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
-      #
-      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
-      #
-      # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
-      #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
-      #
-      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ContextDev::Models::BrandRetrieveByIsinResponse]
-      #
-      # @see ContextDev::Models::BrandRetrieveByIsinParams
-      def retrieve_by_isin(params)
-        parsed, options = ContextDev::BrandRetrieveByIsinParams.dump_request(params)
-        query = ContextDev::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "brand/retrieve-by-isin",
-          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
-          model: ContextDev::Models::BrandRetrieveByIsinResponse,
-          options: options
-        )
-      end
-
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::BrandRetrieveByNameParams} for more details.
-      #
-      # Retrieve brand information using a company name.
-      #
-      # @overload retrieve_by_name(name:, country_gl: nil, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
-      #
-      # @param name [String] Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft Corporati
-      #
-      # @param country_gl [Symbol, ContextDev::Models::BrandRetrieveByNameParams::CountryGl] Optional country code hint (GL parameter) to specify the country for the company
-      #
-      # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByNameParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
-      #
-      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
-      #
-      # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
-      #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
-      #
-      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ContextDev::Models::BrandRetrieveByNameResponse]
-      #
-      # @see ContextDev::Models::BrandRetrieveByNameParams
-      def retrieve_by_name(params)
-        parsed, options = ContextDev::BrandRetrieveByNameParams.dump_request(params)
-        query = ContextDev::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "brand/retrieve-by-name",
-          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
-          model: ContextDev::Models::BrandRetrieveByNameResponse,
-          options: options
-        )
-      end
-
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::BrandRetrieveByTickerParams} for more details.
-      #
-      # Retrieve brand information using a stock ticker symbol.
-      #
-      # @overload retrieve_by_ticker(ticker:, force_language: nil, max_age_ms: nil, max_speed: nil, ticker_exchange: nil, timeout_ms: nil, request_options: {})
-      #
-      # @param ticker [String] Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
-      #
-      # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByTickerParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
-      #
-      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
-      #
-      # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
-      #
-      # @param ticker_exchange [Symbol, ContextDev::Models::BrandRetrieveByTickerParams::TickerExchange] Optional stock exchange for the ticker. Defaults to NASDAQ if not specified.
-      #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
-      #
-      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ContextDev::Models::BrandRetrieveByTickerResponse]
-      #
-      # @see ContextDev::Models::BrandRetrieveByTickerParams
-      def retrieve_by_ticker(params)
-        parsed, options = ContextDev::BrandRetrieveByTickerParams.dump_request(params)
-        query = ContextDev::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "brand/retrieve-by-ticker",
-          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
-          model: ContextDev::Models::BrandRetrieveByTickerResponse,
-          options: options
-        )
-      end
-
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::BrandRetrieveSimplifiedParams} for more details.
       #

data/lib/context_dev/resources/monitors.rb

@@ -0,0 +1,352 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Resources
+    # Monitor pages, sitemaps, and extracted website data for exact or semantic
+    # changes. The change.detected webhook payload is documented by the
+    # MonitorsChangeDetectedWebhookPayload schema.
+    class Monitors
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorCreateParams} for more details.
+      #
+      # Creates a monitor. The request body is a union of the supported target/change
+      # detection combinations. The monitor runs immediately after creation to create
+      # its initial baseline.
+      #
+      # @overload create(change_detection:, name:, schedule:, target:, mode: nil, tags: nil, webhook: nil, request_options: {})
+      #
+      # @param change_detection [ContextDev::Models::MonitorCreateParams::ChangeDetection::Exact, ContextDev::Models::MonitorCreateParams::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+      #
+      # @param name [String]
+      #
+      # @param schedule [ContextDev::Models::MonitorCreateParams::Schedule] Run the monitor on a fixed interval defined by a frequency and a unit, e.g. ever
+      #
+      # @param target [ContextDev::Models::MonitorCreateParams::Target::Page, ContextDev::Models::MonitorCreateParams::Target::Sitemap, ContextDev::Models::MonitorCreateParams::Target::Extract] Discriminated union describing what the monitor watches.
+      #
+      # @param mode [Symbol, ContextDev::Models::MonitorCreateParams::Mode] Top-level monitor category. Always `web` today; the concrete behavior is describ
+      #
+      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+      #
+      # @param webhook [ContextDev::Models::MonitorCreateParams::Webhook, nil]
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorCreateResponse]
+      #
+      # @see ContextDev::Models::MonitorCreateParams
+      def create(params)
+        parsed, options = ContextDev::MonitorCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "monitors",
+          body: parsed,
+          model: ContextDev::Models::MonitorCreateResponse,
+          options: options
+        )
+      end
+
+      # Get a monitor
+      #
+      # @overload retrieve(monitor_id, request_options: {})
+      #
+      # @param monitor_id [String]
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorRetrieveResponse]
+      #
+      # @see ContextDev::Models::MonitorRetrieveParams
+      def retrieve(monitor_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["monitors/%1$s", monitor_id],
+          model: ContextDev::Models::MonitorRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorUpdateParams} for more details.
+      #
+      # Updates a monitor. If `target` or `change_detection` changes, the monitor
+      # creates a new baseline. Unsupported target/change detection combinations are
+      # rejected.
+      #
+      # @overload update(monitor_id, change_detection: nil, name: nil, schedule: nil, status: nil, tags: nil, target: nil, webhook: nil, request_options: {})
+      #
+      # @param monitor_id [String]
+      #
+      # @param change_detection [ContextDev::Models::MonitorUpdateParams::ChangeDetection::Exact, ContextDev::Models::MonitorUpdateParams::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+      #
+      # @param name [String]
+      #
+      # @param schedule [ContextDev::Models::MonitorUpdateParams::Schedule] Run the monitor on a fixed interval defined by a frequency and a unit, e.g. ever
+      #
+      # @param status [Symbol, ContextDev::Models::MonitorUpdateParams::Status]
+      #
+      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes.
+      #
+      # @param target [ContextDev::Models::MonitorUpdateParams::Target::Page, ContextDev::Models::MonitorUpdateParams::Target::Sitemap, ContextDev::Models::MonitorUpdateParams::Target::Extract] Discriminated union describing what the monitor watches.
+      #
+      # @param webhook [ContextDev::Models::MonitorUpdateParams::Webhook, nil] Set to null to remove the webhook.
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorUpdateResponse]
+      #
+      # @see ContextDev::Models::MonitorUpdateParams
+      def update(monitor_id, params = {})
+        parsed, options = ContextDev::MonitorUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["monitors/%1$s", monitor_id],
+          body: parsed,
+          model: ContextDev::Models::MonitorUpdateResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorListParams} for more details.
+      #
+      # Lists monitors for the authenticated organization. Supports free-text search
+      # (`q` over `search_by` fields, `prefix` or `exact` via `search_type`) plus
+      # status/type/tag filters. Results are paginated via the opaque `cursor`.
+      #
+      # @overload list(change_detection_type: nil, cursor: nil, limit: nil, q: nil, search_by: nil, search_type: nil, status: nil, tag: nil, tags: nil, target_type: nil, request_options: {})
+      #
+      # @param change_detection_type [Symbol, ContextDev::Models::MonitorListParams::ChangeDetectionType]
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param q [String] Free-text search term, matched against the fields named in `search_by`.
+      #
+      # @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>] Comma-separated fields to search with `q`. Defaults to all of them. Note `instru
+      #
+      # @param search_type [Symbol, ContextDev::Models::MonitorListParams::SearchType] `prefix` for as-you-type prefix matching (default), `exact` for full-token match
+      #
+      # @param status [Symbol, ContextDev::Models::MonitorListParams::Status] Monitor lifecycle status. `failed` means the most recent run failed (see the mon
+      #
+      # @param tag [String] Filter to items that have this tag.
+      #
+      # @param tags [Array<String>] Comma-separated list of tags to filter by (matches monitors having any of them).
+      #
+      # @param target_type [Symbol, ContextDev::Models::MonitorListParams::TargetType]
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListResponse]
+      #
+      # @see ContextDev::Models::MonitorListParams
+      def list(params = {})
+        parsed, options = ContextDev::MonitorListParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "monitors",
+          query: query,
+          model: ContextDev::Models::MonitorListResponse,
+          options: options
+        )
+      end
+
+      # Delete a monitor
+      #
+      # @overload delete(monitor_id, request_options: {})
+      #
+      # @param monitor_id [String]
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorDeleteResponse]
+      #
+      # @see ContextDev::Models::MonitorDeleteParams
+      def delete(monitor_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["monitors/%1$s", monitor_id],
+          model: ContextDev::Models::MonitorDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Returns an account-wide feed of detected changes across monitors.
+      #
+      # @overload list_account_changes(change_detection_type: nil, cursor: nil, limit: nil, monitor_id: nil, since: nil, tag: nil, target_type: nil, until_: nil, request_options: {})
+      #
+      # @param change_detection_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::ChangeDetectionType]
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param monitor_id [String]
+      #
+      # @param since [Time]
+      #
+      # @param tag [String] Filter to items that have this tag.
+      #
+      # @param target_type [Symbol, ContextDev::Models::MonitorListAccountChangesParams::TargetType]
+      #
+      # @param until_ [Time]
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListAccountChangesResponse]
+      #
+      # @see ContextDev::Models::MonitorListAccountChangesParams
+      def list_account_changes(params = {})
+        parsed, options = ContextDev::MonitorListAccountChangesParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "monitors/changes",
+          query: query.transform_keys(until_: "until"),
+          model: ContextDev::Models::MonitorListAccountChangesResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorListAccountRunsParams} for more details.
+      #
+      # Returns an account-wide feed of monitor runs across all monitors.
+      #
+      # @overload list_account_runs(cursor: nil, limit: nil, status: nil, request_options: {})
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param status [Symbol, ContextDev::Models::MonitorListAccountRunsParams::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListAccountRunsResponse]
+      #
+      # @see ContextDev::Models::MonitorListAccountRunsParams
+      def list_account_runs(params = {})
+        parsed, options = ContextDev::MonitorListAccountRunsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "monitors/runs",
+          query: query,
+          model: ContextDev::Models::MonitorListAccountRunsResponse,
+          options: options
+        )
+      end
+
+      # List changes for a monitor
+      #
+      # @overload list_changes(monitor_id, cursor: nil, limit: nil, since: nil, tag: nil, until_: nil, request_options: {})
+      #
+      # @param monitor_id [String]
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param since [Time]
+      #
+      # @param tag [String] Filter to items that have this tag.
+      #
+      # @param until_ [Time]
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListChangesResponse]
+      #
+      # @see ContextDev::Models::MonitorListChangesParams
+      def list_changes(monitor_id, params = {})
+        parsed, options = ContextDev::MonitorListChangesParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["monitors/%1$s/changes", monitor_id],
+          query: query.transform_keys(until_: "until"),
+          model: ContextDev::Models::MonitorListChangesResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::MonitorListRunsParams} for more details.
+      #
+      # List monitor runs
+      #
+      # @overload list_runs(monitor_id, cursor: nil, limit: nil, status: nil, request_options: {})
+      #
+      # @param monitor_id [String]
+      #
+      # @param cursor [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param status [Symbol, ContextDev::Models::MonitorListRunsParams::Status] Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (in
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorListRunsResponse]
+      #
+      # @see ContextDev::Models::MonitorListRunsParams
+      def list_runs(monitor_id, params = {})
+        parsed, options = ContextDev::MonitorListRunsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["monitors/%1$s/runs", monitor_id],
+          query: query,
+          model: ContextDev::Models::MonitorListRunsResponse,
+          options: options
+        )
+      end
+
+      # Get a change
+      #
+      # @overload retrieve_change(change_id, request_options: {})
+      #
+      # @param change_id [String]
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorRetrieveChangeResponse]
+      #
+      # @see ContextDev::Models::MonitorRetrieveChangeParams
+      def retrieve_change(change_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["monitors/changes/%1$s", change_id],
+          model: ContextDev::Models::MonitorRetrieveChangeResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Triggers an immediate run of the monitor outside its normal schedule. The run is
+      # queued and processed asynchronously.
+      #
+      # @overload run(monitor_id, request_options: {})
+      #
+      # @param monitor_id [String]
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::MonitorRunResponse]
+      #
+      # @see ContextDev::Models::MonitorRunParams
+      def run(monitor_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["monitors/%1$s/run", monitor_id],
+          model: ContextDev::Models::MonitorRunResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [ContextDev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/context_dev/resources/utility.rb

@@ -6,12 +6,16 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::UtilityPrefetchParams} for more details.
       #
-      # Signal that you may fetch brand data for a particular domain soon to improve
-      # latency.
+      # Signal that you may fetch brand data soon to improve latency. The type field
+      # selects what to prefetch (currently only 'brand') and identifier carries exactly
+      # one lookup key: a domain, or an email whose domain is extracted and validated
+      # (free email providers and disposable email addresses are not allowed).
       #
-      # @overload prefetch(domain:, timeout_ms: nil, request_options: {})
+      # @overload prefetch(identifier:, type:, timeout_ms: nil, request_options: {})
       #
-      # @param domain [String] Domain name to prefetch brand data for
+      # @param identifier [ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchDomainIdentifier, ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier] Identifier of the brand to prefetch. Provide exactly one of domain or email.
+      #
+      # @param type [Symbol, ContextDev::Models::UtilityPrefetchParams::Type] What to prefetch. Currently only 'brand' is supported.
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
@@ -24,43 +28,13 @@ module ContextDev
         parsed, options = ContextDev::UtilityPrefetchParams.dump_request(params)
         @client.request(
           method: :post,
-          path: "brand/prefetch",
+          path: "utility/prefetch",
           body: parsed,
           model: ContextDev::Models::UtilityPrefetchResponse,
           options: options
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::UtilityPrefetchByEmailParams} for more details.
-      #
-      # Signal that you may fetch brand data for a particular domain soon to improve
-      # latency. This endpoint accepts an email address, extracts the domain from it,
-      # validates that it's not a disposable or free email provider, and queues the
-      # domain for prefetching.
-      #
-      # @overload prefetch_by_email(email:, timeout_ms: nil, request_options: {})
-      #
-      # @param email [String] Email address to prefetch brand data for. The domain will be extracted from the
-      #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
-      #
-      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [ContextDev::Models::UtilityPrefetchByEmailResponse]
-      #
-      # @see ContextDev::Models::UtilityPrefetchByEmailParams
-      def prefetch_by_email(params)
-        parsed, options = ContextDev::UtilityPrefetchByEmailParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "brand/prefetch-by-email",
-          body: parsed,
-          model: ContextDev::Models::UtilityPrefetchByEmailResponse,
-          options: options
-        )
-      end
-
       # @api private
       #
       # @param client [ContextDev::Client]