feat(api): OpenAPI spec update via Stainless API (#1140)

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 1256
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-8698fc16cc1cd7549c7f51bf3f3118b80e198b25fee1f20e4aaeb226608dafd1.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-129ae207bac48d5f0a569cefeb5ff52209e7ef746666eb4e8f72aeb08a7748aa.yml

src/resources/dns/firewall/firewall.ts

@@ -139,12 +139,16 @@ export interface Firewall {
   ecs_fallback: boolean;
 
   /**
-   * Maximum DNS Cache TTL.
+   * Maximum DNS cache TTL. This setting sets an upper bound on DNS TTLs for purposes
+   * of caching between DNS Firewall and the upstream servers. Higher TTLs will be
+   * decreased to the maximum defined here for caching purposes.
    */
   maximum_cache_ttl: number;
 
   /**
-   * Minimum DNS Cache TTL.
+   * Minimum DNS cache TTL. This setting sets a lower bound on DNS TTLs for purposes
+   * of caching between DNS Firewall and the upstream servers. Lower TTLs will be
+   * increased to the minimum defined here for caching purposes.
    */
   minimum_cache_ttl: number;
 
@@ -166,7 +170,8 @@ export interface Firewall {
   attack_mitigation?: AttackMitigation | null;
 
   /**
-   * Negative DNS Cache TTL.
+   * Negative DNS cache TTL. This setting controls how long DNS Firewall should cache
+   * negative responses (e.g., NXDOMAIN) from the upstream servers.
    */
   negative_cache_ttl?: number | null;
 
@@ -243,17 +248,22 @@ export interface FirewallCreateParams {
   ecs_fallback?: boolean;
 
   /**
-   * Body param: Maximum DNS Cache TTL.
+   * Body param: Maximum DNS cache TTL. This setting sets an upper bound on DNS TTLs
+   * for purposes of caching between DNS Firewall and the upstream servers. Higher
+   * TTLs will be decreased to the maximum defined here for caching purposes.
    */
   maximum_cache_ttl?: number;
 
   /**
-   * Body param: Minimum DNS Cache TTL.
+   * Body param: Minimum DNS cache TTL. This setting sets a lower bound on DNS TTLs
+   * for purposes of caching between DNS Firewall and the upstream servers. Lower
+   * TTLs will be increased to the minimum defined here for caching purposes.
    */
   minimum_cache_ttl?: number;
 
   /**
-   * Body param: Negative DNS Cache TTL.
+   * Body param: Negative DNS cache TTL. This setting controls how long DNS Firewall
+   * should cache negative responses (e.g., NXDOMAIN) from the upstream servers.
    */
   negative_cache_ttl?: number | null;
 
@@ -312,12 +322,16 @@ export interface FirewallEditParams {
   ecs_fallback: boolean;
 
   /**
-   * Body param: Maximum DNS Cache TTL.
+   * Body param: Maximum DNS cache TTL. This setting sets an upper bound on DNS TTLs
+   * for purposes of caching between DNS Firewall and the upstream servers. Higher
+   * TTLs will be decreased to the maximum defined here for caching purposes.
    */
   maximum_cache_ttl: number;
 
   /**
-   * Body param: Minimum DNS Cache TTL.
+   * Body param: Minimum DNS cache TTL. This setting sets a lower bound on DNS TTLs
+   * for purposes of caching between DNS Firewall and the upstream servers. Lower
+   * TTLs will be increased to the minimum defined here for caching purposes.
    */
   minimum_cache_ttl: number;
 
@@ -337,7 +351,8 @@ export interface FirewallEditParams {
   attack_mitigation?: AttackMitigationParam | null;
 
   /**
-   * Body param: Negative DNS Cache TTL.
+   * Body param: Negative DNS cache TTL. This setting controls how long DNS Firewall
+   * should cache negative responses (e.g., NXDOMAIN) from the upstream servers.
    */
   negative_cache_ttl?: number | null;