context.dev 2.15.0 → 2.17.0

data/lib/context_dev/models/log_list_response.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Logs#list
+    class LogListResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute data
+      #   Log entries, newest first.
+      #
+      #   @return [Array<ContextDev::Models::LogListResponse::Data>]
+      required :data, -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::LogListResponse::Data] }
+
+      # @!attribute has_more
+      #   Whether a next page exists.
+      #
+      #   @return [Boolean]
+      required :has_more, ContextDev::Internal::Type::Boolean
+
+      # @!attribute limit
+      #   Entries per page.
+      #
+      #   @return [Integer]
+      required :limit, Integer
+
+      # @!attribute page
+      #   Current page number.
+      #
+      #   @return [Integer]
+      required :page, Integer
+
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
+      # @!attribute key_metadata
+      #   Credit usage, included whenever a valid API key is provided.
+      #
+      #   @return [ContextDev::Models::LogListResponse::KeyMetadata, nil]
+      optional :key_metadata, -> { ContextDev::Models::LogListResponse::KeyMetadata }
+
+      # @!method initialize(data:, has_more:, limit:, page:, request_id:, key_metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::LogListResponse} for more details.
+      #
+      #   @param data [Array<ContextDev::Models::LogListResponse::Data>] Log entries, newest first.
+      #
+      #   @param has_more [Boolean] Whether a next page exists.
+      #
+      #   @param limit [Integer] Entries per page.
+      #
+      #   @param page [Integer] Current page number.
+      #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
+      #   @param key_metadata [ContextDev::Models::LogListResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
+
+      class Data < ContextDev::Internal::Type::BaseModel
+        # @!attribute credits_used
+        #   Credits charged for this request.
+        #
+        #   @return [Integer]
+        required :credits_used, Integer
+
+        # @!attribute error_code
+        #   The `error_code` from the response, or null on success.
+        #
+        #   @return [String, nil]
+        required :error_code, String, nil?: true
+
+        # @!attribute key_id
+        #   ID of the API key that made the request.
+        #
+        #   @return [String, nil]
+        required :key_id, String, nil?: true
+
+        # @!attribute latency_ms
+        #   Server-side processing time in milliseconds.
+        #
+        #   @return [Float]
+        required :latency_ms, Float
+
+        # @!attribute method_
+        #   HTTP method.
+        #
+        #   @return [String]
+        required :method_, String, api_name: :method
+
+        # @!attribute path
+        #   Endpoint path as called.
+        #
+        #   @return [String]
+        required :path, String
+
+        # @!attribute request_id
+        #   Request ID of the logged API call.
+        #
+        #   @return [String]
+        required :request_id, String
+
+        # @!attribute status_code
+        #   HTTP status code returned.
+        #
+        #   @return [Integer]
+        required :status_code, Integer
+
+        # @!attribute tags
+        #   Request tags supplied by the caller.
+        #
+        #   @return [Array<String>]
+        required :tags, ContextDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute timestamp
+        #   When the request completed.
+        #
+        #   @return [Time]
+        required :timestamp, Time
+
+        # @!attribute zdr
+        #   Whether the request was made under zero data retention.
+        #
+        #   @return [Boolean]
+        required :zdr, ContextDev::Internal::Type::Boolean
+
+        # @!method initialize(credits_used:, error_code:, key_id:, latency_ms:, method_:, path:, request_id:, status_code:, tags:, timestamp:, zdr:)
+        #   @param credits_used [Integer] Credits charged for this request.
+        #
+        #   @param error_code [String, nil] The `error_code` from the response, or null on success.
+        #
+        #   @param key_id [String, nil] ID of the API key that made the request.
+        #
+        #   @param latency_ms [Float] Server-side processing time in milliseconds.
+        #
+        #   @param method_ [String] HTTP method.
+        #
+        #   @param path [String] Endpoint path as called.
+        #
+        #   @param request_id [String] Request ID of the logged API call.
+        #
+        #   @param status_code [Integer] HTTP status code returned.
+        #
+        #   @param tags [Array<String>] Request tags supplied by the caller.
+        #
+        #   @param timestamp [Time] When the request completed.
+        #
+        #   @param zdr [Boolean] Whether the request was made under zero data retention.
+      end
+
+      # @see ContextDev::Models::LogListResponse#key_metadata
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        # @!attribute credits_consumed
+        #   Credits used by this request.
+        #
+        #   @return [Integer]
+        required :credits_consumed, Integer
+
+        # @!attribute credits_remaining
+        #   Credits remaining for your organization.
+        #
+        #   @return [Integer]
+        required :credits_remaining, Integer
+
+        # @!method initialize(credits_consumed:, credits_remaining:)
+        #   Credit usage, included whenever a valid API key is provided.
+        #
+        #   @param credits_consumed [Integer] Credits used by this request.
+        #
+        #   @param credits_remaining [Integer] Credits remaining for your organization.
+      end
+    end
+  end
+end

data/lib/context_dev/models/log_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Logs#retrieve
+    class LogRetrieveParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute request_id
+      #   The request ID of the logged API call.
+      #
+      #   @return [String]
+      required :request_id, String
+
+      # @!method initialize(request_id:, request_options: {})
+      #   @param request_id [String] The request ID of the logged API call.
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/context_dev/models/log_retrieve_response.rb

@@ -0,0 +1,226 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Logs#retrieve
+    class LogRetrieveResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [ContextDev::Models::LogRetrieveResponse::Data]
+      required :data, -> { ContextDev::Models::LogRetrieveResponse::Data }
+
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
+      # @!attribute key_metadata
+      #   Credit usage, included whenever a valid API key is provided.
+      #
+      #   @return [ContextDev::Models::LogRetrieveResponse::KeyMetadata, nil]
+      optional :key_metadata, -> { ContextDev::Models::LogRetrieveResponse::KeyMetadata }
+
+      # @!method initialize(data:, request_id:, key_metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::LogRetrieveResponse} for more details.
+      #
+      #   @param data [ContextDev::Models::LogRetrieveResponse::Data]
+      #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
+      #   @param key_metadata [ContextDev::Models::LogRetrieveResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
+
+      # @see ContextDev::Models::LogRetrieveResponse#data
+      class Data < ContextDev::Internal::Type::BaseModel
+        # @!attribute credits_used
+        #   Credits charged for this request.
+        #
+        #   @return [Integer]
+        required :credits_used, Integer
+
+        # @!attribute error_code
+        #   The `error_code` from the response, or null on success.
+        #
+        #   @return [String, nil]
+        required :error_code, String, nil?: true
+
+        # @!attribute input
+        #   What was sent with the request.
+        #
+        #   @return [ContextDev::Models::LogRetrieveResponse::Data::Input]
+        required :input, -> { ContextDev::Models::LogRetrieveResponse::Data::Input }
+
+        # @!attribute key_id
+        #   ID of the API key that made the request.
+        #
+        #   @return [String, nil]
+        required :key_id, String, nil?: true
+
+        # @!attribute latency_ms
+        #   Server-side processing time in milliseconds.
+        #
+        #   @return [Float]
+        required :latency_ms, Float
+
+        # @!attribute method_
+        #   HTTP method.
+        #
+        #   @return [String]
+        required :method_, String, api_name: :method
+
+        # @!attribute path
+        #   Endpoint path as called.
+        #
+        #   @return [String]
+        required :path, String
+
+        # @!attribute request_id
+        #   Request ID of the logged API call.
+        #
+        #   @return [String]
+        required :request_id, String
+
+        # @!attribute status_code
+        #   HTTP status code returned.
+        #
+        #   @return [Integer]
+        required :status_code, Integer
+
+        # @!attribute tags
+        #   Request tags supplied by the caller.
+        #
+        #   @return [Array<String>]
+        required :tags, ContextDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute timestamp
+        #   When the request completed.
+        #
+        #   @return [Time]
+        required :timestamp, Time
+
+        # @!attribute user_agent
+        #   User-Agent header of the request.
+        #
+        #   @return [String, nil]
+        required :user_agent, String, nil?: true
+
+        # @!attribute zdr
+        #   Whether the request was made under zero data retention.
+        #
+        #   @return [Boolean]
+        required :zdr, ContextDev::Internal::Type::Boolean
+
+        # @!attribute key_metadata
+        #   Credit usage, included whenever a valid API key is provided.
+        #
+        #   @return [ContextDev::Models::LogRetrieveResponse::Data::KeyMetadata, nil]
+        optional :key_metadata, -> { ContextDev::Models::LogRetrieveResponse::Data::KeyMetadata }
+
+        # @!attribute response
+        #   The retained JSON response with credentials redacted, or null when unavailable.
+        #
+        #   @return [Object, nil]
+        optional :response, ContextDev::Internal::Type::Unknown
+
+        # @!method initialize(credits_used:, error_code:, input:, key_id:, latency_ms:, method_:, path:, request_id:, status_code:, tags:, timestamp:, user_agent:, zdr:, key_metadata: nil, response: nil)
+        #   @param credits_used [Integer] Credits charged for this request.
+        #
+        #   @param error_code [String, nil] The `error_code` from the response, or null on success.
+        #
+        #   @param input [ContextDev::Models::LogRetrieveResponse::Data::Input] What was sent with the request.
+        #
+        #   @param key_id [String, nil] ID of the API key that made the request.
+        #
+        #   @param latency_ms [Float] Server-side processing time in milliseconds.
+        #
+        #   @param method_ [String] HTTP method.
+        #
+        #   @param path [String] Endpoint path as called.
+        #
+        #   @param request_id [String] Request ID of the logged API call.
+        #
+        #   @param status_code [Integer] HTTP status code returned.
+        #
+        #   @param tags [Array<String>] Request tags supplied by the caller.
+        #
+        #   @param timestamp [Time] When the request completed.
+        #
+        #   @param user_agent [String, nil] User-Agent header of the request.
+        #
+        #   @param zdr [Boolean] Whether the request was made under zero data retention.
+        #
+        #   @param key_metadata [ContextDev::Models::LogRetrieveResponse::Data::KeyMetadata] Credit usage, included whenever a valid API key is provided.
+        #
+        #   @param response [Object] The retained JSON response with credentials redacted, or null when unavailable.
+
+        # @see ContextDev::Models::LogRetrieveResponse::Data#input
+        class Input < ContextDev::Internal::Type::BaseModel
+          # @!attribute query
+          #   Query parameters as sent.
+          #
+          #   @return [Hash{Symbol=>Object}]
+          required :query, ContextDev::Internal::Type::HashOf[ContextDev::Internal::Type::Unknown]
+
+          # @!attribute body
+          #   Request body with credentials and uploaded content redacted.
+          #
+          #   @return [Object, nil]
+          optional :body, ContextDev::Internal::Type::Unknown
+
+          # @!method initialize(query:, body: nil)
+          #   What was sent with the request.
+          #
+          #   @param query [Hash{Symbol=>Object}] Query parameters as sent.
+          #
+          #   @param body [Object] Request body with credentials and uploaded content redacted.
+        end
+
+        # @see ContextDev::Models::LogRetrieveResponse::Data#key_metadata
+        class KeyMetadata < ContextDev::Internal::Type::BaseModel
+          # @!attribute credits_consumed
+          #   Credits used by this request.
+          #
+          #   @return [Integer]
+          required :credits_consumed, Integer
+
+          # @!attribute credits_remaining
+          #   Credits remaining for your organization.
+          #
+          #   @return [Integer]
+          required :credits_remaining, Integer
+
+          # @!method initialize(credits_consumed:, credits_remaining:)
+          #   Credit usage, included whenever a valid API key is provided.
+          #
+          #   @param credits_consumed [Integer] Credits used by this request.
+          #
+          #   @param credits_remaining [Integer] Credits remaining for your organization.
+        end
+      end
+
+      # @see ContextDev::Models::LogRetrieveResponse#key_metadata
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        # @!attribute credits_consumed
+        #   Credits used by this request.
+        #
+        #   @return [Integer]
+        required :credits_consumed, Integer
+
+        # @!attribute credits_remaining
+        #   Credits remaining for your organization.
+        #
+        #   @return [Integer]
+        required :credits_remaining, Integer
+
+        # @!method initialize(credits_consumed:, credits_remaining:)
+        #   Credit usage, included whenever a valid API key is provided.
+        #
+        #   @param credits_consumed [Integer] Credits used by this request.
+        #
+        #   @param credits_remaining [Integer] Credits remaining for your organization.
+      end
+    end
+  end
+end

data/lib/context_dev/models/monitor_create_params.rb

@@ -97,6 +97,25 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute exclude_selectors
+          #   CSS selectors for HTML regions to remove before text extraction. Applied after
+          #   include_selectors; exclusion takes precedence when an element matches both. Omit
+          #   or pass an empty array to apply no explicit exclusions. Changing these selectors
+          #   creates a new baseline.
+          #
+          #   @return [Array<String>, nil]
+          optional :exclude_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
+          # @!attribute include_selectors
+          #   CSS selectors defining the HTML regions to monitor. Matching subtrees are
+          #   combined in document order before text extraction, instead of automatic
+          #   main-content selection. Omit or pass an empty array to use automatic
+          #   main-content extraction. If the filtered page has no usable text, the run fails
+          #   without replacing the baseline. Changing these selectors creates a new baseline.
+          #
+          #   @return [Array<String>, nil]
+          optional :include_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
           # @!attribute instructions
           #   Plain-language goal describing which page changes matter. When provided without
           #   change_detection, semantic detection is inferred.
@@ -110,7 +129,7 @@ module ContextDev
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          # @!method initialize(url:, exclude_selectors: nil, include_selectors: nil, instructions: nil, normalize_whitespace: nil, type: :page)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::MonitorCreateParams::Target::Page} for more details.
           #
@@ -119,6 +138,10 @@ module ContextDev
           #
           #   @param url [String]
           #
+          #   @param exclude_selectors [Array<String>] CSS selectors for HTML regions to remove before text extraction. Applied after i
+          #
+          #   @param include_selectors [Array<String>] CSS selectors defining the HTML regions to monitor. Matching subtrees are combin
+          #
           #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
           #
           #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
@@ -371,7 +394,8 @@ module ContextDev
 
       class Webhook < ContextDev::Internal::Type::BaseModel
         # @!attribute url
-        #   Webhook URL events are delivered to.
+        #   Webhook URL events are delivered to. Slack incoming webhook URLs are
+        #   automatically formatted as Slack messages.
         #
         #   @return [String]
         required :url, String
@@ -396,7 +420,7 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorCreateParams::Webhook} for more details.
         #
-        #   @param url [String] Webhook URL events are delivered to.
+        #   @param url [String] Webhook URL events are delivered to. Slack incoming webhook URLs are automatical
         #
         #   @param events [Array<Symbol, ContextDev::Models::MonitorCreateParams::Webhook::Event>] Events delivered to this endpoint. `change.detected` fires only when a run detec
         #

data/lib/context_dev/models/monitor_create_response.rb

@@ -331,6 +331,25 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute exclude_selectors
+          #   CSS selectors for HTML regions to remove before text extraction. Applied after
+          #   include_selectors; exclusion takes precedence when an element matches both. Omit
+          #   or pass an empty array to apply no explicit exclusions. Changing these selectors
+          #   creates a new baseline.
+          #
+          #   @return [Array<String>, nil]
+          optional :exclude_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
+          # @!attribute include_selectors
+          #   CSS selectors defining the HTML regions to monitor. Matching subtrees are
+          #   combined in document order before text extraction, instead of automatic
+          #   main-content selection. Omit or pass an empty array to use automatic
+          #   main-content extraction. If the filtered page has no usable text, the run fails
+          #   without replacing the baseline. Changing these selectors creates a new baseline.
+          #
+          #   @return [Array<String>, nil]
+          optional :include_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
           # @!attribute instructions
           #   Plain-language goal describing which page changes matter. When provided without
           #   change_detection, semantic detection is inferred.
@@ -344,7 +363,7 @@ module ContextDev
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          # @!method initialize(url:, exclude_selectors: nil, include_selectors: nil, instructions: nil, normalize_whitespace: nil, type: :page)
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::MonitorCreateResponse::Target::Page} for more details.
           #
@@ -353,6 +372,10 @@ module ContextDev
           #
           #   @param url [String]
           #
+          #   @param exclude_selectors [Array<String>] CSS selectors for HTML regions to remove before text extraction. Applied after i
+          #
+          #   @param include_selectors [Array<String>] CSS selectors defining the HTML regions to monitor. Matching subtrees are combin
+          #
           #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
           #
           #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
@@ -618,7 +641,8 @@ module ContextDev
       # @see ContextDev::Models::MonitorCreateResponse#webhook
       class Webhook < ContextDev::Internal::Type::BaseModel
         # @!attribute url
-        #   Webhook URL events are delivered to.
+        #   Webhook URL events are delivered to. Slack incoming webhook URLs are
+        #   automatically formatted as Slack messages.
         #
         #   @return [String]
         required :url, String
@@ -641,7 +665,8 @@ module ContextDev
 
         response_only do
           # @!attribute secret
-          #   Signing secret used to verify webhook authenticity. Each delivery includes an
+          #   Signing secret used to verify webhook authenticity. Omitted unless the API key
+          #   has monitors:write permission or full access. Each delivery includes an
           #   `X-Context-Signature: t=<unix>,v1=<hmac>` header, where the HMAC is SHA-256 over
           #   `"{t}.{rawRequestBody}"` keyed by this secret. Recompute it with a constant-time
           #   compare and reject stale timestamps to prevent replay. Generated by the API;
@@ -655,13 +680,13 @@ module ContextDev
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::MonitorCreateResponse::Webhook} for more details.
         #
-        #   @param url [String] Webhook URL events are delivered to.
+        #   @param url [String] Webhook URL events are delivered to. Slack incoming webhook URLs are automatical
         #
         #   @param events [Array<Symbol, ContextDev::Models::MonitorCreateResponse::Webhook::Event>] Events delivered to this endpoint. `change.detected` fires only when a run detec
         #
         #   @param retry_ [ContextDev::Models::RetryConfig] Webhook retry settings. Use {} for the default schedule.
         #
-        #   @param secret [String] Signing secret used to verify webhook authenticity. Each delivery includes an `X
+        #   @param secret [String] Signing secret used to verify webhook authenticity. Omitted unless the API key h
 
         module Event
           extend ContextDev::Internal::Type::Enum

data/lib/context_dev/models/monitor_list_response.rb

@@ -344,6 +344,25 @@ module ContextDev
             #   @return [String]
             required :url, String
 
+            # @!attribute exclude_selectors
+            #   CSS selectors for HTML regions to remove before text extraction. Applied after
+            #   include_selectors; exclusion takes precedence when an element matches both. Omit
+            #   or pass an empty array to apply no explicit exclusions. Changing these selectors
+            #   creates a new baseline.
+            #
+            #   @return [Array<String>, nil]
+            optional :exclude_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
+            # @!attribute include_selectors
+            #   CSS selectors defining the HTML regions to monitor. Matching subtrees are
+            #   combined in document order before text extraction, instead of automatic
+            #   main-content selection. Omit or pass an empty array to use automatic
+            #   main-content extraction. If the filtered page has no usable text, the run fails
+            #   without replacing the baseline. Changing these selectors creates a new baseline.
+            #
+            #   @return [Array<String>, nil]
+            optional :include_selectors, ContextDev::Internal::Type::ArrayOf[String]
+
             # @!attribute instructions
             #   Plain-language goal describing which page changes matter. When provided without
             #   change_detection, semantic detection is inferred.
@@ -357,7 +376,7 @@ module ContextDev
             #   @return [Boolean, nil]
             optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-            # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+            # @!method initialize(url:, exclude_selectors: nil, include_selectors: nil, instructions: nil, normalize_whitespace: nil, type: :page)
             #   Some parameter documentations has been truncated, see
             #   {ContextDev::Models::MonitorListResponse::Data::Target::Page} for more details.
             #
@@ -366,6 +385,10 @@ module ContextDev
             #
             #   @param url [String]
             #
+            #   @param exclude_selectors [Array<String>] CSS selectors for HTML regions to remove before text extraction. Applied after i
+            #
+            #   @param include_selectors [Array<String>] CSS selectors defining the HTML regions to monitor. Matching subtrees are combin
+            #
             #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
             #
             #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
@@ -632,7 +655,8 @@ module ContextDev
         # @see ContextDev::Models::MonitorListResponse::Data#webhook
         class Webhook < ContextDev::Internal::Type::BaseModel
           # @!attribute url
-          #   Webhook URL events are delivered to.
+          #   Webhook URL events are delivered to. Slack incoming webhook URLs are
+          #   automatically formatted as Slack messages.
           #
           #   @return [String]
           required :url, String
@@ -655,7 +679,8 @@ module ContextDev
 
           response_only do
             # @!attribute secret
-            #   Signing secret used to verify webhook authenticity. Each delivery includes an
+            #   Signing secret used to verify webhook authenticity. Omitted unless the API key
+            #   has monitors:write permission or full access. Each delivery includes an
             #   `X-Context-Signature: t=<unix>,v1=<hmac>` header, where the HMAC is SHA-256 over
             #   `"{t}.{rawRequestBody}"` keyed by this secret. Recompute it with a constant-time
             #   compare and reject stale timestamps to prevent replay. Generated by the API;
@@ -669,13 +694,13 @@ module ContextDev
           #   Some parameter documentations has been truncated, see
           #   {ContextDev::Models::MonitorListResponse::Data::Webhook} for more details.
           #
-          #   @param url [String] Webhook URL events are delivered to.
+          #   @param url [String] Webhook URL events are delivered to. Slack incoming webhook URLs are automatical
           #
           #   @param events [Array<Symbol, ContextDev::Models::MonitorListResponse::Data::Webhook::Event>] Events delivered to this endpoint. `change.detected` fires only when a run detec
           #
           #   @param retry_ [ContextDev::Models::RetryConfig] Webhook retry settings. Use {} for the default schedule.
           #
-          #   @param secret [String] Signing secret used to verify webhook authenticity. Each delivery includes an `X
+          #   @param secret [String] Signing secret used to verify webhook authenticity. Omitted unless the API key h
 
           module Event
             extend ContextDev::Internal::Type::Enum