context.dev 2.21.0 → 2.22.0

data/lib/context_dev/resources/feedback.rb

@@ -2,14 +2,13 @@
 
 module ContextDev
   module Resources
-    # Report bugs, docs mismatches, and friction with any Context.dev API. Submissions
-    # cost no credits and use a separate rate limit.
+    # Report API issues and documentation mismatches.
     class Feedback
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::FeedbackSubmitParams} for more details.
       #
-      # Report a problem with a Context.dev API call, docs page, SDK, or CLI. Include
-      # request_id, url, or both.
+      # Report an API issue or documentation mismatch, including request IDs when
+      # available.
       #
       # @overload submit(category:, note:, request_id: nil, tags: nil, url: nil, request_options: {})
       #
@@ -19,7 +18,7 @@ module ContextDev
       #
       # @param request_id [String] The request_id of the API call the feedback is about, from its response body or
       #
-      # @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      # @param tags [Array<String>] Labels for filtering usage in the dashboard.
       #
       # @param url [String] The page the feedback is about, such as one page of a crawl or a docs page.
       #

data/lib/context_dev/resources/industry.rb

@@ -6,7 +6,7 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::IndustryRetrieveNaicsParams} for more details.
       #
-      # Classify any brand into 2022 NAICS industry codes from its domain or name.
+      # Classify a company into NAICS industry codes.
       #
       # @overload retrieve_naics(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #
@@ -16,11 +16,11 @@ module ContextDev
       #
       # @param min_results [Integer] Minimum number of NAICS codes to return. Must be at least 1. Defaults to 1.
       #
-      # @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
+      # @param tags [Array<String>] Comma-separated labels for filtering usage, e.g. `production,team-alpha`.
       #
-      # @param timeout_opts [ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+      # @param timeout_opts [ContextDev::Models::IndustryRetrieveNaicsParams::TimeoutOpts] Request deadline and what to return when it passes.
       #
-      # @param zdr [Symbol, ContextDev::Models::IndustryRetrieveNaicsParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      # @param zdr [Symbol, ContextDev::Models::IndustryRetrieveNaicsParams::Zdr] `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless you
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -46,9 +46,7 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::IndustryRetrieveSicParams} for more details.
       #
-      # Classify any brand into Standard Industrial Classification (SIC) codes from its
-      # domain or name. Choose between the original SIC system (`original_sic`) or the
-      # latest SIC list maintained by the SEC (`latest_sec`).
+      # Classify a company into SIC industry codes.
       #
       # @overload retrieve_sic(input:, max_results: nil, min_results: nil, tags: nil, timeout_opts: nil, type: nil, zdr: nil, request_options: {})
       #
@@ -58,13 +56,13 @@ module ContextDev
       #
       # @param min_results [Integer] Minimum number of SIC codes to return. Must be at least 1. Defaults to 1.
       #
-      # @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
+      # @param tags [Array<String>] Comma-separated labels for filtering usage, e.g. `production,team-alpha`.
       #
-      # @param timeout_opts [ContextDev::Models::IndustryRetrieveSicParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+      # @param timeout_opts [ContextDev::Models::IndustryRetrieveSicParams::TimeoutOpts] Request deadline and what to return when it passes.
       #
-      # @param type [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type] Which SIC dataset to classify against. `original_sic` uses the 1987 Standard Ind
+      # @param type [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Type] SIC dataset: `original_sic` (1987) or `latest_sec` (current SEC list).
       #
-      # @param zdr [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      # @param zdr [Symbol, ContextDev::Models::IndustryRetrieveSicParams::Zdr] `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless you
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/context_dev/resources/logs.rb

@@ -2,10 +2,9 @@
 
 module ContextDev
   module Resources
-    # Read your organization's API request logs to debug failed calls. These endpoints
-    # cost no credits and use a separate rate limit.
+    # Read your organization's API request logs.
     class Logs
-      # Get one logged API call, including its request input and response body.
+      # Retrieve a request’s metadata, retained input, and response.
       #
       # @overload retrieve(request_id, request_options: {})
       #
@@ -28,8 +27,8 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::LogListParams} for more details.
       #
-      # List your organization's API requests, newest first. Defaults to the last 24
-      # hours.
+      # List your organization’s request logs with filters and pagination. Logs also
+      # include batch settlements and monitor runs.
       #
       # @overload list(error_code: nil, errors_only: nil, from: nil, key_id: nil, limit: nil, page: nil, path: nil, search: nil, status_code: nil, tags: nil, to: nil, request_options: {})
       #

data/lib/context_dev/resources/monitors.rb

@@ -2,33 +2,29 @@
 
 module ContextDev
   module Resources
-    # Monitor pages, sitemaps, and extracted website data for exact or semantic
-    # changes. Webhook payloads are documented by the
-    # MonitorsChangeDetectedWebhookPayload and MonitorsRunCompletedWebhookPayload
-    # schemas.
+    # Watch websites for exact or meaningful changes.
     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.
+      # Watch a page, URL inventory, or extracted website data on a schedule. A run
+      # starts immediately to capture the baseline.
       #
       # @overload create(name:, target:, change_detection: nil, mode: nil, schedule: nil, tags: nil, webhook: nil, request_options: {})
       #
-      # @param name [String]
+      # @param name [String] Display name for the monitor.
       #
-      # @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 target [ContextDev::Models::MonitorCreateParams::Target::Page, ContextDev::Models::MonitorCreateParams::Target::Sitemap, ContextDev::Models::MonitorCreateParams::Target::Extract] What to watch: a page, a sitemap, or data extracted from a site.
       #
-      # @param change_detection [ContextDev::Models::MonitorCreateParams::ChangeDetection::Exact, ContextDev::Models::MonitorCreateParams::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+      # @param change_detection [ContextDev::Models::MonitorCreateParams::ChangeDetection::Exact, ContextDev::Models::MonitorCreateParams::ChangeDetection::Semantic] How changes are judged. Defaults to `semantic` for extract targets and page targ
       #
-      # @param mode [Symbol, ContextDev::Models::MonitorCreateParams::Mode] Top-level monitor category. Always `web` today; the concrete behavior is describ
+      # @param mode [Symbol, ContextDev::Models::MonitorCreateParams::Mode] Always `web`. Optional.
       #
       # @param schedule [ContextDev::Models::MonitorCreateParams::Schedule] Run the monitor on a fixed interval defined by a frequency and a unit, e.g. ever
       #
-      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
+      # @param tags [Array<String>] Labels for filtering monitors, their changes, and their usage.
       #
-      # @param webhook [ContextDev::Models::MonitorCreateParams::Webhook, nil]
+      # @param webhook [ContextDev::Models::MonitorCreateParams::Webhook, nil] Webhook destination and delivery settings. Null means no webhook is configured.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -46,11 +42,12 @@ module ContextDev
         )
       end
 
-      # Get a monitor
+      # Retrieve a monitor’s configuration and current state.
       #
       # @overload retrieve(monitor_id, request_options: {})
       #
-      # @param monitor_id [String]
+      # @param monitor_id [String] ID of the monitor.
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::MonitorRetrieveResponse]
@@ -68,27 +65,26 @@ module ContextDev
       # 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.
+      # Update a monitor. Changing its target or change detection replaces the baseline
+      # and queues a new baseline run.
       #
       # @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 monitor_id [String] ID of the monitor.
       #
-      # @param change_detection [ContextDev::Models::MonitorUpdateParams::ChangeDetection::Exact, ContextDev::Models::MonitorUpdateParams::ChangeDetection::Semantic] Discriminated union describing how changes are detected.
+      # @param change_detection [ContextDev::Models::MonitorUpdateParams::ChangeDetection::Exact, ContextDev::Models::MonitorUpdateParams::ChangeDetection::Semantic] How changes are judged. Defaults to `semantic` for extract targets and page targ
       #
-      # @param name [String]
+      # @param name [String] Display name for the monitor.
       #
       # @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 status [Symbol, ContextDev::Models::MonitorUpdateParams::Status] Set `paused` to stop scheduled runs or `active` to resume them.
       #
-      # @param tags [Array<String>] User-defined tags for grouping and filtering monitors and their changes. Duplica
+      # @param tags [Array<String>] Labels for filtering monitors, their changes, and their usage.
       #
-      # @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 target [ContextDev::Models::MonitorUpdateParams::Target::Page, ContextDev::Models::MonitorUpdateParams::Target::Sitemap, ContextDev::Models::MonitorUpdateParams::Target::Extract] What to watch: a page, a sitemap, or data extracted from a site.
       #
-      # @param webhook [ContextDev::Models::MonitorUpdateParams::Webhook, nil] Set to null to remove the webhook.
+      # @param webhook [ContextDev::Models::MonitorUpdateParams::Webhook, nil] Set to null to remove the webhook. Changing `url` issues a new secret.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -109,9 +105,7 @@ module ContextDev
       # 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`.
+      # List your monitors with optional search and filters.
       #
       # @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: {})
       #
@@ -123,7 +117,7 @@ module ContextDev
       #
       # @param q [String] Free-text search term, matched against the fields named in `search_by`.
       #
-      # @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>, nil] Comma-separated fields to search with `q`. Defaults to all of them. Note `instru
+      # @param search_by [Array<Symbol, ContextDev::Models::MonitorListParams::SearchBy>, nil] Fields to search with `q`. Defaults to all fields; page and extract targets can
       #
       # @param search_type [Symbol, ContextDev::Models::MonitorListParams::SearchType] `prefix` for as-you-type prefix matching (default), `exact` for full-token match
       #
@@ -152,11 +146,12 @@ module ContextDev
         )
       end
 
-      # Delete a monitor
+      # Delete a monitor and stop future runs and webhook retries.
       #
       # @overload delete(monitor_id, request_options: {})
       #
-      # @param monitor_id [String]
+      # @param monitor_id [String] ID of the monitor.
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::MonitorDeleteResponse]
@@ -171,8 +166,8 @@ module ContextDev
         )
       end
 
-      # Returns credits charged per monitor over an optional [since, until] window,
-      # newest spenders first.
+      # Return usage per monitor, highest first, for up to the 10,000 most recent runs
+      # in the requested window.
       #
       # @overload get_credit_usage(since: nil, until_: nil, request_options: {})
       #
@@ -197,7 +192,7 @@ module ContextDev
         )
       end
 
-      # Returns how many monitors the account has and the maximum it allows.
+      # Retrieve your organization’s monitor allowance and usage.
       #
       # @overload get_limits(request_options: {})
       #
@@ -215,7 +210,7 @@ module ContextDev
         )
       end
 
-      # Returns an account-wide feed of detected changes across monitors.
+      # List full change records across your monitors, newest first.
       #
       # @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: {})
       #
@@ -252,7 +247,7 @@ module ContextDev
         )
       end
 
-      # Returns an account-wide feed of monitor runs across all monitors.
+      # List runs across your monitors, newest first.
       #
       # @overload list_account_runs(cursor: nil, limit: nil, status: nil, request_options: {})
       #
@@ -279,11 +274,11 @@ module ContextDev
         )
       end
 
-      # List changes for a monitor
+      # List full change records for a monitor, newest first.
       #
       # @overload list_changes(monitor_id, cursor: nil, limit: nil, since: nil, tag: nil, until_: nil, request_options: {})
       #
-      # @param monitor_id [String]
+      # @param monitor_id [String] ID of the monitor.
       #
       # @param cursor [String] Opaque pagination cursor from a previous response.
       #
@@ -312,11 +307,11 @@ module ContextDev
         )
       end
 
-      # List monitor runs
+      # List a monitor’s runs, newest first.
       #
       # @overload list_runs(monitor_id, cursor: nil, limit: nil, status: nil, request_options: {})
       #
-      # @param monitor_id [String]
+      # @param monitor_id [String] ID of the monitor.
       #
       # @param cursor [String] Opaque pagination cursor from a previous response.
       #
@@ -341,11 +336,12 @@ module ContextDev
         )
       end
 
-      # Get a change
+      # Retrieve a detected change, including its diff and available evidence.
       #
       # @overload retrieve_change(change_id, request_options: {})
       #
-      # @param change_id [String]
+      # @param change_id [String] ID of the detected change.
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::MonitorRetrieveChangeResponse]
@@ -360,13 +356,14 @@ module ContextDev
         )
       end
 
-      # Fetches one run for a monitor, including lifecycle status, timing, credits
-      # charged, and any detected change.
+      # Retrieve the status, timing, and results of one monitor run.
       #
       # @overload retrieve_run(run_id, monitor_id:, request_options: {})
       #
-      # @param run_id [String]
-      # @param monitor_id [String]
+      # @param run_id [String] ID of the monitor run.
+      #
+      # @param monitor_id [String] ID of the monitor.
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::MonitorRetrieveRunResponse]
@@ -386,13 +383,13 @@ module ContextDev
         )
       end
 
-      # Generates a new signing secret for the monitor's webhook and returns the updated
-      # monitor (including the new `webhook.secret`). The previous secret stops signing
-      # deliveries immediately, so update your endpoint before rotating.
+      # Generate and return a new signing secret. It takes effect immediately for all
+      # subsequent delivery attempts.
       #
       # @overload rotate_webhook_secret(monitor_id, request_options: {})
       #
-      # @param monitor_id [String]
+      # @param monitor_id [String] ID of the monitor.
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::MonitorRotateWebhookSecretResponse]
@@ -407,12 +404,12 @@ module ContextDev
         )
       end
 
-      # Triggers an immediate run of the monitor outside its normal schedule. The run is
-      # queued and processed asynchronously.
+      # Queue a run without changing the regular schedule. Paused monitors return 409.
       #
       # @overload run(monitor_id, request_options: {})
       #
-      # @param monitor_id [String]
+      # @param monitor_id [String] ID of the monitor.
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::MonitorRunResponse]

data/lib/context_dev/resources/news.rb

@@ -2,17 +2,13 @@
 
 module ContextDev
   module Resources
-    # Search live first-party RSS and free historical news data by company identity.
+    # Search live and historical news about a company.
     class News
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::NewsSearchParams} for more details.
       #
-      # Searches live and historical company news for one company, identified in
-      # searchBy by name, domain, ticker (optionally disambiguated by exchange), or
-      # ISIN. Results can be filtered by one of publisher domain, publisher country,
-      # article language, or article type, optionally combined with a published-at date
-      # range, and include stable story IDs, source metadata, verified entity relevance,
-      # and cursor pagination.
+      # Find company news by name, domain, ticker, or ISIN. Filter articles and continue
+      # through results with a cursor.
       #
       # @overload search(search_by:, cursor: nil, filter_by: nil, limit: nil, sort_by: nil, tags: nil, request_options: {})
       #
@@ -26,7 +22,7 @@ module ContextDev
       #
       # @param sort_by [ContextDev::Models::NewsSearchParams::SortBy] Result ordering. Defaults to newest.
       #
-      # @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      # @param tags [Array<String>] Labels for filtering usage in the dashboard.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/context_dev/resources/parse.rb

@@ -6,8 +6,7 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::ParseHandleParams} for more details.
       #
-      # Converts raw text, source code, web/data, PDF, Microsoft Office, and image bytes
-      # into LLM-usable Markdown.
+      # Convert uploaded file bytes into Markdown and optional HTML.
       #
       # @overload handle(body:, client: nil, extension: nil, include_images: nil, include_links: nil, ocr: nil, pdf: nil, shorten_base64_images: nil, tags: nil, use_main_content_only: nil, zdr: nil, request_options: {})
       #
@@ -21,17 +20,17 @@ module ContextDev
       #
       # @param include_links [Boolean] Query param: Preserve hyperlinks in Markdown output
       #
-      # @param ocr [Boolean] Query param: When true for PDF inputs, OCR the selected pages that have no usabl
+      # @param ocr [Boolean] Query param: Read text from images and scanned PDF pages. PDF page ranges still
       #
       # @param pdf [ContextDev::Models::ParseHandleParams::Pdf] Query param: PDF page-range options as a JSON object, e.g. {"start": 2, "end": 5
       #
       # @param shorten_base64_images [Boolean] Query param: Shorten base64-encoded image data in the Markdown output
       #
-      # @param tags [Array<String>] Query param: Comma-separated tags for tracking request usage. Up to 20 tags, eac
+      # @param tags [Array<String>] Query param: Comma-separated labels for filtering usage, e.g. `production,team-a
       #
       # @param use_main_content_only [Boolean] Query param: Extract only the main content from HTML-like inputs
       #
-      # @param zdr [Symbol, ContextDev::Models::ParseHandleParams::Zdr] Query param: Set to enabled to bypass shared caches and omit request and respons
+      # @param zdr [Symbol, ContextDev::Models::ParseHandleParams::Zdr] Query param: `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLE
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/context_dev/resources/people.rb

@@ -6,30 +6,28 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::PersonEnrichParams} for more details.
       #
-      # Finds and normalizes the best available person candidate from additive identity
-      # clues, then assigns an identity match score from 0 to 100. Available on all paid
-      # plans. Successful requests cost 20 credits. Disposable and free email addresses
-      # (like gmail.com, yahoo.com) will throw a 422 error.
+      # Find a person from identity clues and return their profile with a match score.
+      # Requires a paid plan; free or disposable email addresses return 422.
       #
       # @overload enrich(company: nil, education: nil, email: nil, location: nil, name: nil, social_urls: nil, tags: nil, timeout_opts: nil, zdr: nil, request_options: {})
       #
-      # @param company [ContextDev::Models::PersonEnrichParams::Company]
+      # @param company [ContextDev::Models::PersonEnrichParams::Company] Company context to help identify the person. Provide a name or domain.
       #
-      # @param education [Array<ContextDev::Models::PersonEnrichParams::Education>]
+      # @param education [Array<ContextDev::Models::PersonEnrichParams::Education>] Education history to help distinguish people with similar names.
       #
-      # @param email [String]
+      # @param email [String] Email address of the person to find.
       #
-      # @param location [ContextDev::Models::PersonEnrichParams::Location]
+      # @param location [ContextDev::Models::PersonEnrichParams::Location] Location context to help identify the person. Provide a city, region, or country
       #
-      # @param name [ContextDev::Models::PersonEnrichParams::Name]
+      # @param name [ContextDev::Models::PersonEnrichParams::Name] Person name. Without an email or person-profile URL, provide both first and last
       #
-      # @param social_urls [Array<String>]
+      # @param social_urls [Array<String>] Public profile URLs for the person. A person-profile URL can identify the person
       #
-      # @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      # @param tags [Array<String>] Labels for filtering usage in the dashboard.
       #
-      # @param timeout_opts [ContextDev::Models::PersonEnrichParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+      # @param timeout_opts [ContextDev::Models::PersonEnrichParams::TimeoutOpts] Request deadline and what to return when it passes.
       #
-      # @param zdr [Symbol, ContextDev::Models::PersonEnrichParams::Zdr] Set to enabled to bypass shared caches and omit request and response content fro
+      # @param zdr [Symbol, ContextDev::Models::PersonEnrichParams::Zdr] `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless you
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/context_dev/resources/utility.rb

@@ -3,24 +3,17 @@
 module ContextDev
   module Resources
     class Utility
-      # Some parameter documentations has been truncated, see
-      # {ContextDev::Models::UtilityPrefetchParams} for more details.
-      #
-      # Signal that you may fetch data soon to improve latency. The type field selects
-      # what to prefetch ('brand' queues a brand data fetch, 'styleguide' queues a
-      # styleguide extraction) 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).
+      # Queue brand or styleguide data so a later lookup can return sooner.
       #
       # @overload prefetch(identifier:, type:, tags: nil, timeout_opts: nil, request_options: {})
       #
       # @param identifier [ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchDomainIdentifier, ContextDev::Models::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier] Identifier of the target to prefetch. Provide exactly one of domain or email.
       #
-      # @param type [Symbol, ContextDev::Models::UtilityPrefetchParams::Type] What to prefetch: 'brand' warms the brand data cache, 'styleguide' warms the sty
+      # @param type [Symbol, ContextDev::Models::UtilityPrefetchParams::Type] Data to prefetch.
       #
-      # @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      # @param tags [Array<String>] Labels for filtering usage in the dashboard.
       #
-      # @param timeout_opts [ContextDev::Models::UtilityPrefetchParams::TimeoutOpts] Optional request deadline and behavior on timeout. For GET requests, use timeout
+      # @param timeout_opts [ContextDev::Models::UtilityPrefetchParams::TimeoutOpts] Request deadline and what to return when it passes.
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #