context.dev 2.15.0 → 2.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 515f65691600e29045376881e888810e56f7df8cc0c1a65a9b5077f9c72c1258
-  data.tar.gz: 521f7a02b0d575c2bb3f624b73dbdd8ec3fcd892fd5f6115016e2f751e9ff470
+  metadata.gz: f386d4f27c72c64c88946d5e8dbc98bb1cd4f5de22f6400219eb7996954c68df
+  data.tar.gz: 062cb685ad8d8469e9e4f81e42d809533d98b0b68c009c57b285a77578023fdb
 SHA512:
-  metadata.gz: e1a0aad5bc3dc9521467690dc7c1d2cc8500a4fed431fed65c89fe9443807a97b8e9ce4badc89abd5918d9bbfd8f223306d26438cc579142bb2f0fde4d6a4492
-  data.tar.gz: b9e69f23af6eebf3b8da837b926b6622fa1977afa07b39dac78485e2cb1c798eb5362dca640f5bf9a7f177631ed739944f3ca2837e7e21eb54b316b78977bdef
+  metadata.gz: ec3879167f8c90f9c79ea728be1f927ff23c089ca6103255c7ea64294adfa117a616e9a83f72439a72ee710ca2fa0b66a8fa44e5eac649ceda206f04bb324cd4
+  data.tar.gz: 2a2945c6da42e4ec238ecbb23dec1803bf65b2c857c864152e6919c66d35b981aa5b6696848d29b0d541e1810bec79ab19a7462a4ef6c58e70df5c4f9d355f42

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [2.16.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.15.0...v2.16.0) (2026-09-11)
+
+
+### Features
+
+* **api:** return request_id on every response ([012ba65](https://github.com/context-dot-dev/context-ruby-sdk/commit/012ba65ea7648ebd7b18fa7ad00955a13b8394b9))
+* **logs:** expose request log endpoints in SDKs ([#1025](https://github.com/context-dot-dev/context-ruby-sdk/issues/1025)) ([5b22be7](https://github.com/context-dot-dev/context-ruby-sdk/commit/5b22be7bd1cb6401b8260b5a756b6ec040cbc6a8))
+
+
+### Bug Fixes
+
+* **api:** reject timeoutMS too short for waitForMs ([e8a6725](https://github.com/context-dot-dev/context-ruby-sdk/commit/e8a67255c9354f69d632697179a4d6270a4677ee))
+
 ## [2.15.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.14.0...v2.15.0) (2026-09-08)
 
 

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 2.15.0"
+gem "context.dev", "~> 2.16.0"
 ```
 
 <!-- x-release-please-end -->
@@ -34,7 +34,7 @@ context_dev = ContextDev::Client.new(
 
 brand = context_dev.brand.retrieve(body: {domain: "stripe.com", type: "by_domain"})
 
-puts(brand.cache_metadata)
+puts(brand.request_id)
 ```
 
 ### Handling errors

data/lib/context_dev/client.rb

@@ -57,6 +57,11 @@ module ContextDev
     # @return [ContextDev::Resources::News]
     attr_reader :news
 
+    # Read your organization's API request logs to debug failed calls. These endpoints
+    # cost no credits and use a separate rate limit.
+    # @return [ContextDev::Resources::Logs]
+    attr_reader :logs
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -129,6 +134,7 @@ module ContextDev
       @webhooks = ContextDev::Resources::Webhooks.new(client: self)
       @people = ContextDev::Resources::People.new(client: self)
       @news = ContextDev::Resources::News.new(client: self)
+      @logs = ContextDev::Resources::Logs.new(client: self)
     end
   end
 end

data/lib/context_dev/internal/type/base_model.rb

@@ -441,8 +441,8 @@ module ContextDev
         #   # `parse_handle_response` is a `ContextDev::Models::ParseHandleResponse`
         #   parse_handle_response => {
         #     markdown: markdown,
-        #     success: success,
-        #     type: type
+        #     request_id: request_id,
+        #     success: success
         #   }
         def deconstruct_keys(keys)
           (keys || self.class.known_fields.keys)

data/lib/context_dev/models/ai_extract_product_response.rb

@@ -12,6 +12,13 @@ module ContextDev
       #   @return [ContextDev::Models::AIExtractProductResponse::CacheMetadata]
       required :cache_metadata, -> { ContextDev::Models::AIExtractProductResponse::CacheMetadata }
 
+      # @!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 is_product_page
       #   Whether the given URL is a product detail page
       #
@@ -36,12 +43,14 @@ module ContextDev
       #   @return [ContextDev::Models::AIExtractProductResponse::Product, nil]
       optional :product, -> { ContextDev::Models::AIExtractProductResponse::Product }, nil?: true
 
-      # @!method initialize(cache_metadata:, is_product_page: nil, key_metadata: nil, platform: nil, product: nil)
+      # @!method initialize(cache_metadata:, request_id:, is_product_page: nil, key_metadata: nil, platform: nil, product: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::AIExtractProductResponse} for more details.
       #
       #   @param cache_metadata [ContextDev::Models::AIExtractProductResponse::CacheMetadata] Cache outcome for this response. Composite responses are hits only when every ca
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param is_product_page [Boolean] Whether the given URL is a product detail page
       #
       #   @param key_metadata [ContextDev::Models::AIExtractProductResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.

data/lib/context_dev/models/ai_extract_products_response.rb

@@ -12,6 +12,13 @@ module ContextDev
       #   @return [ContextDev::Models::AIExtractProductsResponse::CacheMetadata]
       required :cache_metadata, -> { ContextDev::Models::AIExtractProductsResponse::CacheMetadata }
 
+      # @!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.
       #
@@ -25,12 +32,14 @@ module ContextDev
       optional :products,
                -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::AIExtractProductsResponse::Product] }
 
-      # @!method initialize(cache_metadata:, key_metadata: nil, products: nil)
+      # @!method initialize(cache_metadata:, request_id:, key_metadata: nil, products: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::AIExtractProductsResponse} for more details.
       #
       #   @param cache_metadata [ContextDev::Models::AIExtractProductsResponse::CacheMetadata] Cache outcome for this response. Composite responses are hits only when every ca
       #
+      #   @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::AIExtractProductsResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
       #
       #   @param products [Array<ContextDev::Models::AIExtractProductsResponse::Product>] Array of products extracted from the website

data/lib/context_dev/models/batch_cancel_response.rb

@@ -53,6 +53,13 @@ module ContextDev
       #   @return [ContextDev::Models::BatchCancelResponse::Progress]
       required :progress, -> { ContextDev::Models::BatchCancelResponse::Progress }
 
+      # @!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 status
       #   Always `cancelling`. Work already in flight finishes; the batch reaches
       #   `cancelled` shortly after.
@@ -78,7 +85,7 @@ module ContextDev
       #   @return [ContextDev::Models::BatchCancelResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::BatchCancelResponse::KeyMetadata }
 
-      # @!method initialize(id:, crawl:, credits:, format_:, input:, mode:, page_errors:, progress:, status:, tags:, timing:, key_metadata: nil)
+      # @!method initialize(id:, crawl:, credits:, format_:, input:, mode:, page_errors:, progress:, request_id:, status:, tags:, timing:, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BatchCancelResponse} for more details.
       #
@@ -98,6 +105,8 @@ module ContextDev
       #
       #   @param progress [ContextDev::Models::BatchCancelResponse::Progress] How far the batch got before cancellation.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param status [Symbol, ContextDev::Models::BatchCancelResponse::Status] Always `cancelling`. Work already in flight finishes; the batch reaches `cancell
       #
       #   @param tags [Array<String>] Tags stored on the batch at submission.

data/lib/context_dev/models/batch_delete_response.rb

@@ -4,6 +4,13 @@ module ContextDev
   module Models
     # @see ContextDev::Resources::Batch#delete
     class BatchDeleteResponse < ContextDev::Internal::Type::BaseModel
+      # @!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 id
       #   ID of the deleted batch.
       #
@@ -22,7 +29,12 @@ module ContextDev
       #   @return [ContextDev::Models::BatchDeleteResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::BatchDeleteResponse::KeyMetadata }
 
-      # @!method initialize(id: nil, deleted: nil, key_metadata: nil)
+      # @!method initialize(request_id:, id: nil, deleted: nil, key_metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::BatchDeleteResponse} for more details.
+      #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param id [String] ID of the deleted batch.
       #
       #   @param deleted [Boolean] Always true on success.

data/lib/context_dev/models/batch_get_results_response.rb

@@ -4,6 +4,13 @@ module ContextDev
   module Models
     # @see ContextDev::Resources::Batch#get_results
     class BatchGetResultsResponse < ContextDev::Internal::Type::BaseModel
+      # @!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 data
       #   Result records on this page.
       #
@@ -29,7 +36,12 @@ module ContextDev
       #   @return [String, nil]
       optional :next_cursor, String, nil?: true
 
-      # @!method initialize(data: nil, has_more: nil, key_metadata: nil, next_cursor: nil)
+      # @!method initialize(request_id:, data: nil, has_more: nil, key_metadata: nil, next_cursor: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::BatchGetResultsResponse} for more details.
+      #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param data [Array<ContextDev::Models::BatchGetResultsResponse::Data::Ok, ContextDev::Models::BatchGetResultsResponse::Data::Error>] Result records on this page.
       #
       #   @param has_more [Boolean] Whether another page is available.

data/lib/context_dev/models/batch_list_response.rb

@@ -4,6 +4,13 @@ module ContextDev
   module Models
     # @see ContextDev::Resources::Batch#list
     class BatchListResponse < ContextDev::Internal::Type::BaseModel
+      # @!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 data
       #   Batches on this page.
       #
@@ -28,7 +35,12 @@ module ContextDev
       #   @return [String, nil]
       optional :next_cursor, String, nil?: true
 
-      # @!method initialize(data: nil, has_more: nil, key_metadata: nil, next_cursor: nil)
+      # @!method initialize(request_id:, data: nil, has_more: nil, key_metadata: nil, next_cursor: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::BatchListResponse} for more details.
+      #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param data [Array<ContextDev::Models::BatchListResponse::Data>] Batches on this page.
       #
       #   @param has_more [Boolean] Whether another page is available.

data/lib/context_dev/models/batch_retrieve_response.rb

@@ -69,6 +69,13 @@ module ContextDev
       #   @return [ContextDev::Models::BatchRetrieveResponse::Progress]
       required :progress, -> { ContextDev::Models::BatchRetrieveResponse::Progress }
 
+      # @!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 results
       #   Download links, available once the batch reaches a final status and null before
       #   then. GET /batch/{batch_id}/results serves the same records as paginated JSON.
@@ -105,7 +112,7 @@ module ContextDev
       #   @return [String, nil]
       optional :webhook_delivery_id, String
 
-      # @!method initialize(id:, crawl:, credits:, failure:, format_:, input:, invalid_urls:, mode:, page_errors:, progress:, results:, status:, tags:, timing:, key_metadata: nil, webhook_delivery_id: nil)
+      # @!method initialize(id:, crawl:, credits:, failure:, format_:, input:, invalid_urls:, mode:, page_errors:, progress:, request_id:, results:, status:, tags:, timing:, key_metadata: nil, webhook_delivery_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BatchRetrieveResponse} for more details.
       #
@@ -130,6 +137,8 @@ module ContextDev
       #
       #   @param progress [ContextDev::Models::BatchRetrieveResponse::Progress] Pages attempted so far. Use `status` to check completion.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param results [ContextDev::Models::BatchRetrieveResponse::Results, nil] Download links, available once the batch reaches a final status and null before
       #
       #   @param status [Symbol, ContextDev::Models::BatchRetrieveResponse::Status] Current state. `completed`, `cancelled`, and `failed` are final.

data/lib/context_dev/models/batch_submit_response.rb

@@ -62,6 +62,13 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::BatchSubmitResponse::Mode]
       required :mode, enum: -> { ContextDev::Models::BatchSubmitResponse::Mode }
 
+      # @!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 status
       #   Always `queued`. An accepted batch has not started yet.
       #
@@ -87,7 +94,7 @@ module ContextDev
       #   @return [String, nil]
       optional :webhook_secret, String
 
-      # @!method initialize(id:, cache_metadata:, crawl:, created_at:, credits:, format_:, input:, invalid_urls:, mode:, status:, tags:, key_metadata: nil, webhook_secret: nil)
+      # @!method initialize(id:, cache_metadata:, crawl:, created_at:, credits:, format_:, input:, invalid_urls:, mode:, request_id:, status:, tags:, key_metadata: nil, webhook_secret: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BatchSubmitResponse} for more details.
       #
@@ -109,6 +116,8 @@ module ContextDev
       #
       #   @param mode [Symbol, ContextDev::Models::BatchSubmitResponse::Mode] How pages will be selected.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param status [Symbol, ContextDev::Models::BatchSubmitResponse::Status] Always `queued`. An accepted batch has not started yet.
       #
       #   @param tags [Array<String>] Tags stored on the batch.

data/lib/context_dev/models/brand_retrieve_response.rb

@@ -12,6 +12,13 @@ module ContextDev
       #   @return [ContextDev::Models::BrandRetrieveResponse::CacheMetadata]
       required :cache_metadata, -> { ContextDev::Models::BrandRetrieveResponse::CacheMetadata }
 
+      # @!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 brand
       #   Detailed brand information
       #
@@ -36,12 +43,14 @@ module ContextDev
       #   @return [String, nil]
       optional :status, String
 
-      # @!method initialize(cache_metadata:, brand: nil, code: nil, key_metadata: nil, status: nil)
+      # @!method initialize(cache_metadata:, request_id:, brand: nil, code: nil, key_metadata: nil, status: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveResponse} for more details.
       #
       #   @param cache_metadata [ContextDev::Models::BrandRetrieveResponse::CacheMetadata] Cache outcome for this response. Composite responses are hits only when every ca
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param brand [ContextDev::Models::BrandRetrieveResponse::Brand] Detailed brand information
       #
       #   @param code [Integer] HTTP status code

data/lib/context_dev/models/brand_retrieve_simplified_response.rb

@@ -12,6 +12,13 @@ module ContextDev
       #   @return [ContextDev::Models::BrandRetrieveSimplifiedResponse::CacheMetadata]
       required :cache_metadata, -> { ContextDev::Models::BrandRetrieveSimplifiedResponse::CacheMetadata }
 
+      # @!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 brand
       #   Simplified brand information
       #
@@ -36,12 +43,14 @@ module ContextDev
       #   @return [String, nil]
       optional :status, String
 
-      # @!method initialize(cache_metadata:, brand: nil, code: nil, key_metadata: nil, status: nil)
+      # @!method initialize(cache_metadata:, request_id:, brand: nil, code: nil, key_metadata: nil, status: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveSimplifiedResponse} for more details.
       #
       #   @param cache_metadata [ContextDev::Models::BrandRetrieveSimplifiedResponse::CacheMetadata] Cache outcome for this response. Composite responses are hits only when every ca
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param brand [ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand] Simplified brand information
       #
       #   @param code [Integer] HTTP status code of the response

data/lib/context_dev/models/brand_search_response.rb

@@ -4,6 +4,13 @@ module ContextDev
   module Models
     # @see ContextDev::Resources::Brand#search
     class BrandSearchResponse < ContextDev::Internal::Type::BaseModel
+      # @!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 results
       #   Up to 10 matching brands, name matches first, then domain matches, most popular
       #   first within each group. Empty when nothing matches.
@@ -18,10 +25,12 @@ module ContextDev
       #   @return [ContextDev::Models::BrandSearchResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::BrandSearchResponse::KeyMetadata }
 
-      # @!method initialize(results:, key_metadata: nil)
+      # @!method initialize(request_id:, results:, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandSearchResponse} for more details.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param results [Array<ContextDev::Models::BrandSearchResponse::Result>] Up to 10 matching brands, name matches first, then domain matches, most popular
       #
       #   @param key_metadata [ContextDev::Models::BrandSearchResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.

data/lib/context_dev/models/industry_retrieve_naics_response.rb

@@ -4,6 +4,13 @@ module ContextDev
   module Models
     # @see ContextDev::Resources::Industry#retrieve_naics
     class IndustryRetrieveNaicsResponse < ContextDev::Internal::Type::BaseModel
+      # @!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 codes
       #   Array of NAICS codes and titles.
       #
@@ -35,7 +42,12 @@ module ContextDev
       #   @return [String, nil]
       optional :type, String
 
-      # @!method initialize(codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
+      # @!method initialize(request_id:, codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::IndustryRetrieveNaicsResponse} for more details.
+      #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param codes [Array<ContextDev::Models::IndustryRetrieveNaicsResponse::Code>] Array of NAICS codes and titles.
       #
       #   @param domain [String] Domain found for the brand

data/lib/context_dev/models/industry_retrieve_sic_response.rb

@@ -4,6 +4,13 @@ module ContextDev
   module Models
     # @see ContextDev::Resources::Industry#retrieve_sic
     class IndustryRetrieveSicResponse < ContextDev::Internal::Type::BaseModel
+      # @!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 classification
       #   Echoes back which SIC dataset was used to classify the brand.
       #
@@ -43,10 +50,12 @@ module ContextDev
       #   @return [String, nil]
       optional :type, String
 
-      # @!method initialize(classification: nil, codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
+      # @!method initialize(request_id:, classification: nil, codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::IndustryRetrieveSicResponse} for more details.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param classification [Symbol, ContextDev::Models::IndustryRetrieveSicResponse::Classification] Echoes back which SIC dataset was used to classify the brand.
       #
       #   @param codes [Array<ContextDev::Models::IndustryRetrieveSicResponse::Code>] Array of SIC codes with confidence scores. Extra fields depend on the requested

data/lib/context_dev/models/log_list_params.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Logs#list
+    class LogListParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute error_code
+      #   Filter by the `error_code` returned in the response.
+      #
+      #   @return [String, nil]
+      optional :error_code, String
+
+      # @!attribute errors_only
+      #   Only include requests that returned a 4xx or 5xx status.
+      #
+      #   @return [Boolean, nil]
+      optional :errors_only, ContextDev::Internal::Type::Boolean
+
+      # @!attribute from
+      #   Only include requests at or after this ISO 8601 timestamp. Defaults to 24 hours
+      #   before `to`.
+      #
+      #   @return [Time, nil]
+      optional :from, Time
+
+      # @!attribute key_id
+      #   Filter by the API key that made the request.
+      #
+      #   @return [String, nil]
+      optional :key_id, String
+
+      # @!attribute limit
+      #   Number of log entries per page.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute page
+      #   Page number, starting at 1.
+      #
+      #   @return [Integer, nil]
+      optional :page, Integer
+
+      # @!attribute path
+      #   Filter by endpoint path, with or without the /v1 prefix.
+      #
+      #   @return [String, nil]
+      optional :path, String
+
+      # @!attribute search
+      #   Case-insensitive substring match against the request query and body, e.g. a
+      #   domain.
+      #
+      #   @return [String, nil]
+      optional :search, String
+
+      # @!attribute status_code
+      #   Filter by exact HTTP status code.
+      #
+      #   @return [Integer, nil]
+      optional :status_code, Integer
+
+      # @!attribute tags
+      #   Comma-separated request tags. Matches requests carrying any of them. Up to 20
+      #   tags, each 1-50 characters.
+      #
+      #   @return [String, nil]
+      optional :tags, String
+
+      # @!attribute to
+      #   Only include requests at or before this ISO 8601 timestamp. Defaults to now.
+      #
+      #   @return [Time, nil]
+      optional :to, Time
+
+      # @!method initialize(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: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::LogListParams} for more details.
+      #
+      #   @param error_code [String] Filter by the `error_code` returned in the response.
+      #
+      #   @param errors_only [Boolean] Only include requests that returned a 4xx or 5xx status.
+      #
+      #   @param from [Time] Only include requests at or after this ISO 8601 timestamp. Defaults to 24 hours
+      #
+      #   @param key_id [String] Filter by the API key that made the request.
+      #
+      #   @param limit [Integer] Number of log entries per page.
+      #
+      #   @param page [Integer] Page number, starting at 1.
+      #
+      #   @param path [String] Filter by endpoint path, with or without the /v1 prefix.
+      #
+      #   @param search [String] Case-insensitive substring match against the request query and body, e.g. a doma
+      #
+      #   @param status_code [Integer] Filter by exact HTTP status code.
+      #
+      #   @param tags [String] Comma-separated request tags. Matches requests carrying any of them. Up to 20 ta
+      #
+      #   @param to [Time] Only include requests at or before this ISO 8601 timestamp. Defaults to now.
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end