cloudflare 4.2.0 → 4.4.0

package/src/resources/rulesets/rules.ts

@@ -11,6 +11,14 @@ export class Rules extends APIResource {
   /**
    * Adds a new rule to an account or zone ruleset. The rule will be added to the end
    * of the existing list of rules in the ruleset by default.
+   *
+   * @example
+   * ```ts
+   * const rule = await client.rulesets.rules.create(
+   *   '2f2feab2026849078ba485f918791bdc',
+   *   { account_id: 'account_id' },
+   * );
+   * ```
    */
   create(
     rulesetId: string,
@@ -44,6 +52,15 @@ export class Rules extends APIResource {
 
   /**
    * Deletes an existing rule from an account or zone ruleset.
+   *
+   * @example
+   * ```ts
+   * const rule = await client.rulesets.rules.delete(
+   *   '2f2feab2026849078ba485f918791bdc',
+   *   '3a03d665bac047339bb530ecb439a90d',
+   *   { account_id: 'account_id' },
+   * );
+   * ```
    */
   delete(
     rulesetId: string,
@@ -92,6 +109,15 @@ export class Rules extends APIResource {
 
   /**
    * Updates an existing rule in an account or zone ruleset.
+   *
+   * @example
+   * ```ts
+   * const response = await client.rulesets.rules.edit(
+   *   '2f2feab2026849078ba485f918791bdc',
+   *   '3a03d665bac047339bb530ecb439a90d',
+   *   { account_id: 'account_id' },
+   * );
+   * ```
    */
   edit(
     rulesetId: string,
@@ -253,7 +279,7 @@ export namespace BlockRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -405,7 +431,7 @@ export namespace BlockRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -530,7 +556,7 @@ export namespace CompressResponseRule {
       /**
        * Name of compression algorithm to enable.
        */
-      name?: 'none' | 'auto' | 'default' | 'gzip' | 'brotli';
+      name?: 'none' | 'auto' | 'default' | 'gzip' | 'brotli' | 'zstd';
     }
   }
 
@@ -562,7 +588,7 @@ export namespace CompressResponseRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -672,7 +698,7 @@ export namespace CompressResponseRuleParam {
       /**
        * Name of compression algorithm to enable.
        */
-      name?: 'none' | 'auto' | 'default' | 'gzip' | 'brotli';
+      name?: 'none' | 'auto' | 'default' | 'gzip' | 'brotli' | 'zstd';
     }
   }
 
@@ -704,7 +730,7 @@ export namespace CompressResponseRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -839,7 +865,7 @@ export namespace DDoSDynamicRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -959,7 +985,7 @@ export namespace DDoSDynamicRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -1133,7 +1159,7 @@ export namespace ExecuteRule {
 
     export namespace Overrides {
       /**
-       * A category-level override
+       * A category-level override.
        */
       export interface Category {
         /**
@@ -1158,7 +1184,7 @@ export namespace ExecuteRule {
       }
 
       /**
-       * A rule-level override
+       * A rule-level override.
        */
       export interface Rule {
         /**
@@ -1217,7 +1243,7 @@ export namespace ExecuteRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -1376,7 +1402,7 @@ export namespace ExecuteRuleParam {
 
     export namespace Overrides {
       /**
-       * A category-level override
+       * A category-level override.
        */
       export interface Category {
         /**
@@ -1401,7 +1427,7 @@ export namespace ExecuteRuleParam {
       }
 
       /**
-       * A rule-level override
+       * A rule-level override.
        */
       export interface Rule {
         /**
@@ -1460,7 +1486,7 @@ export namespace ExecuteRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -1595,7 +1621,7 @@ export namespace ForceConnectionCloseRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -1715,7 +1741,7 @@ export namespace ForceConnectionCloseRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -1942,7 +1968,7 @@ export namespace LogCustomFieldRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -2154,7 +2180,7 @@ export namespace LogCustomFieldRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -2289,7 +2315,7 @@ export namespace LogRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -2409,7 +2435,7 @@ export namespace LogRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -2564,7 +2590,7 @@ export namespace ManagedChallengeRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -2684,7 +2710,7 @@ export namespace ManagedChallengeRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -2887,7 +2913,7 @@ export namespace RedirectRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -3075,7 +3101,7 @@ export namespace RedirectRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -3191,7 +3217,11 @@ export namespace RewriteRule {
      */
     headers?: Record<
       string,
-      ActionParameters.RemoveHeader | ActionParameters.StaticHeader | ActionParameters.DynamicHeader
+      | ActionParameters.RemoveHeader
+      | ActionParameters.AddStaticHeader
+      | ActionParameters.SetStaticHeader
+      | ActionParameters.AddDynamicHeader
+      | ActionParameters.SetDynamicHeader
     >;
 
     /**
@@ -3208,10 +3238,22 @@ export namespace RewriteRule {
       operation: 'remove';
     }
 
+    /**
+     * Add a request header with a static value.
+     */
+    export interface AddStaticHeader {
+      operation: 'add';
+
+      /**
+       * Static value for the header.
+       */
+      value: string;
+    }
+
     /**
      * Set a request header with a static value.
      */
-    export interface StaticHeader {
+    export interface SetStaticHeader {
       operation: 'set';
 
       /**
@@ -3220,10 +3262,22 @@ export namespace RewriteRule {
       value: string;
     }
 
+    /**
+     * Add a request header with a dynamic value.
+     */
+    export interface AddDynamicHeader {
+      /**
+       * Expression for the header value.
+       */
+      expression: string;
+
+      operation: 'add';
+    }
+
     /**
      * Set a request header with a dynamic value.
      */
-    export interface DynamicHeader {
+    export interface SetDynamicHeader {
       /**
        * Expression for the header value.
        */
@@ -3276,7 +3330,7 @@ export namespace RewriteRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -3377,7 +3431,11 @@ export namespace RewriteRuleParam {
      */
     headers?: Record<
       string,
-      ActionParameters.RemoveHeader | ActionParameters.StaticHeader | ActionParameters.DynamicHeader
+      | ActionParameters.RemoveHeader
+      | ActionParameters.AddStaticHeader
+      | ActionParameters.SetStaticHeader
+      | ActionParameters.AddDynamicHeader
+      | ActionParameters.SetDynamicHeader
     >;
 
     /**
@@ -3394,10 +3452,22 @@ export namespace RewriteRuleParam {
       operation: 'remove';
     }
 
+    /**
+     * Add a request header with a static value.
+     */
+    export interface AddStaticHeader {
+      operation: 'add';
+
+      /**
+       * Static value for the header.
+       */
+      value: string;
+    }
+
     /**
      * Set a request header with a static value.
      */
-    export interface StaticHeader {
+    export interface SetStaticHeader {
       operation: 'set';
 
       /**
@@ -3406,10 +3476,22 @@ export namespace RewriteRuleParam {
       value: string;
     }
 
+    /**
+     * Add a request header with a dynamic value.
+     */
+    export interface AddDynamicHeader {
+      /**
+       * Expression for the header value.
+       */
+      expression: string;
+
+      operation: 'add';
+    }
+
     /**
      * Set a request header with a dynamic value.
      */
-    export interface DynamicHeader {
+    export interface SetDynamicHeader {
       /**
        * Expression for the header value.
        */
@@ -3462,7 +3544,7 @@ export namespace RewriteRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -3680,7 +3762,7 @@ export namespace RouteRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -3847,7 +3929,7 @@ export namespace RouteRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -3982,7 +4064,7 @@ export namespace RulesetRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -4128,7 +4210,7 @@ export namespace ScoreRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -4259,7 +4341,7 @@ export namespace ScoreRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -4414,7 +4496,7 @@ export namespace ServeErrorRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -4554,7 +4636,7 @@ export namespace ServeErrorRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -4709,7 +4791,7 @@ export namespace SetCacheSettingsRule {
 
     /**
      * Generate Cloudflare error pages from issues sent from the origin server. When
-     * on, error pages will trigger for issues from the origin
+     * on, error pages will trigger for issues from the origin.
      */
     origin_error_page_passthru?: boolean;
 
@@ -4760,13 +4842,13 @@ export namespace SetCacheSettingsRule {
      */
     export interface CacheKey {
       /**
-       * Separate cached content based on the visitor’s device type
+       * Separate cached content based on the visitor’s device type.
        */
       cache_by_device_type?: boolean;
 
       /**
        * Protect from web cache deception attacks while allowing static assets to be
-       * cached
+       * cached.
        */
       cache_deception_armor?: boolean;
 
@@ -4990,12 +5072,12 @@ export namespace SetCacheSettingsRule {
       default: number;
 
       /**
-       * edge ttl options
+       * Edge TTL options.
        */
       mode: 'respect_origin' | 'bypass_by_default' | 'override_origin';
 
       /**
-       * List of single status codes, or status code ranges to apply the selected mode
+       * List of single status codes, or status code ranges to apply the selected mode.
        */
       status_code_ttl: Array<EdgeTTL.StatusCodeTTL>;
     }
@@ -5003,7 +5085,7 @@ export namespace SetCacheSettingsRule {
     export namespace EdgeTTL {
       /**
        * Specify how long Cloudflare should cache the response based on the status code
-       * from the origin. Can be a single status code or a range or status codes
+       * from the origin. Can be a single status code or a range or status codes.
        */
       export interface StatusCodeTTL {
         /**
@@ -5019,7 +5101,7 @@ export namespace SetCacheSettingsRule {
         status_code_range?: StatusCodeTTL.StatusCodeRange;
 
         /**
-         * Set the ttl for responses with this specific status code
+         * Set the TTL for responses with this specific status code.
          */
         status_code_value?: number;
       }
@@ -5030,12 +5112,12 @@ export namespace SetCacheSettingsRule {
          */
         export interface StatusCodeRange {
           /**
-           * response status code lower bound
+           * Response status code lower bound.
            */
           from: number;
 
           /**
-           * response status code upper bound
+           * Response status code upper bound.
            */
           to: number;
         }
@@ -5085,7 +5167,7 @@ export namespace SetCacheSettingsRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -5225,7 +5307,7 @@ export namespace SetCacheSettingsRuleParam {
 
     /**
      * Generate Cloudflare error pages from issues sent from the origin server. When
-     * on, error pages will trigger for issues from the origin
+     * on, error pages will trigger for issues from the origin.
      */
     origin_error_page_passthru?: boolean;
 
@@ -5276,13 +5358,13 @@ export namespace SetCacheSettingsRuleParam {
      */
     export interface CacheKey {
       /**
-       * Separate cached content based on the visitor’s device type
+       * Separate cached content based on the visitor’s device type.
        */
       cache_by_device_type?: boolean;
 
       /**
        * Protect from web cache deception attacks while allowing static assets to be
-       * cached
+       * cached.
        */
       cache_deception_armor?: boolean;
 
@@ -5506,12 +5588,12 @@ export namespace SetCacheSettingsRuleParam {
       default: number;
 
       /**
-       * edge ttl options
+       * Edge TTL options.
        */
       mode: 'respect_origin' | 'bypass_by_default' | 'override_origin';
 
       /**
-       * List of single status codes, or status code ranges to apply the selected mode
+       * List of single status codes, or status code ranges to apply the selected mode.
        */
       status_code_ttl: Array<EdgeTTL.StatusCodeTTL>;
     }
@@ -5519,7 +5601,7 @@ export namespace SetCacheSettingsRuleParam {
     export namespace EdgeTTL {
       /**
        * Specify how long Cloudflare should cache the response based on the status code
-       * from the origin. Can be a single status code or a range or status codes
+       * from the origin. Can be a single status code or a range or status codes.
        */
       export interface StatusCodeTTL {
         /**
@@ -5535,7 +5617,7 @@ export namespace SetCacheSettingsRuleParam {
         status_code_range?: StatusCodeTTL.StatusCodeRange;
 
         /**
-         * Set the ttl for responses with this specific status code
+         * Set the TTL for responses with this specific status code.
          */
         status_code_value?: number;
       }
@@ -5546,12 +5628,12 @@ export namespace SetCacheSettingsRuleParam {
          */
         export interface StatusCodeRange {
           /**
-           * response status code lower bound
+           * Response status code lower bound.
            */
           from: number;
 
           /**
-           * response status code upper bound
+           * Response status code upper bound.
            */
           to: number;
         }
@@ -5601,7 +5683,7 @@ export namespace SetCacheSettingsRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -5770,10 +5852,10 @@ export namespace SetConfigRule {
     /**
      * Configure the Polish level.
      */
-    polish?: 'off' | 'lossless' | 'lossy';
+    polish?: 'off' | 'lossless' | 'lossy' | 'webp';
 
     /**
-     * Turn on or off Rocket Loader
+     * Turn on or off Rocket Loader.
      */
     rocket_loader?: boolean;
 
@@ -5848,7 +5930,7 @@ export namespace SetConfigRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -6002,10 +6084,10 @@ export namespace SetConfigRuleParam {
     /**
      * Configure the Polish level.
      */
-    polish?: 'off' | 'lossless' | 'lossy';
+    polish?: 'off' | 'lossless' | 'lossy' | 'webp';
 
     /**
-     * Turn on or off Rocket Loader
+     * Turn on or off Rocket Loader.
      */
     rocket_loader?: boolean;
 
@@ -6080,7 +6162,7 @@ export namespace SetConfigRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -6193,7 +6275,7 @@ export namespace SkipRule {
   export interface ActionParameters {
     /**
      * A list of phases to skip the execution of. This option is incompatible with the
-     * ruleset and rulesets options.
+     * rulesets option.
      */
     phases?: Array<RulesetsAPI.Phase>;
 
@@ -6210,7 +6292,7 @@ export namespace SkipRule {
 
     /**
      * A ruleset to skip the execution of. This option is incompatible with the
-     * rulesets, rules and phases options.
+     * rulesets option.
      */
     ruleset?: 'current';
 
@@ -6249,7 +6331,7 @@ export namespace SkipRule {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -6347,7 +6429,7 @@ export namespace SkipRuleParam {
   export interface ActionParameters {
     /**
      * A list of phases to skip the execution of. This option is incompatible with the
-     * ruleset and rulesets options.
+     * rulesets option.
      */
     phases?: Array<RulesetsAPI.PhaseParam>;
 
@@ -6364,7 +6446,7 @@ export namespace SkipRuleParam {
 
     /**
      * A ruleset to skip the execution of. This option is incompatible with the
-     * rulesets, rules and phases options.
+     * rulesets option.
      */
     ruleset?: 'current';
 
@@ -6403,7 +6485,7 @@ export namespace SkipRuleParam {
     /**
      * Period in seconds over which the counter is being incremented.
      */
-    period: 10 | 60 | 600 | 3600;
+    period: number;
 
     /**
      * Defines when the ratelimit counter should be incremented. It is optional and
@@ -6603,7 +6685,7 @@ export namespace RuleCreateResponse {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -6738,7 +6820,7 @@ export namespace RuleCreateResponse {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -6939,7 +7021,7 @@ export namespace RuleDeleteResponse {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -7074,7 +7156,7 @@ export namespace RuleDeleteResponse {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -7275,7 +7357,7 @@ export namespace RuleEditResponse {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -7410,7 +7492,7 @@ export namespace RuleEditResponse {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -7633,7 +7715,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -7802,7 +7884,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -7929,7 +8011,7 @@ export declare namespace RuleCreateParams {
         /**
          * Name of compression algorithm to enable.
          */
-        name?: 'none' | 'auto' | 'default' | 'gzip' | 'brotli';
+        name?: 'none' | 'auto' | 'default' | 'gzip' | 'brotli' | 'zstd';
       }
     }
 
@@ -7993,7 +8075,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -8169,7 +8251,7 @@ export declare namespace RuleCreateParams {
 
       export namespace Overrides {
         /**
-         * A category-level override
+         * A category-level override.
          */
         export interface Category {
           /**
@@ -8194,7 +8276,7 @@ export declare namespace RuleCreateParams {
         }
 
         /**
-         * A rule-level override
+         * A rule-level override.
          */
         export interface Rule {
           /**
@@ -8285,7 +8367,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -8457,7 +8539,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -8626,7 +8708,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -8798,7 +8880,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -9035,7 +9117,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -9153,7 +9235,11 @@ export declare namespace RuleCreateParams {
        */
       headers?: Record<
         string,
-        ActionParameters.RemoveHeader | ActionParameters.StaticHeader | ActionParameters.DynamicHeader
+        | ActionParameters.RemoveHeader
+        | ActionParameters.AddStaticHeader
+        | ActionParameters.SetStaticHeader
+        | ActionParameters.AddDynamicHeader
+        | ActionParameters.SetDynamicHeader
       >;
 
       /**
@@ -9170,10 +9256,22 @@ export declare namespace RuleCreateParams {
         operation: 'remove';
       }
 
+      /**
+       * Add a request header with a static value.
+       */
+      export interface AddStaticHeader {
+        operation: 'add';
+
+        /**
+         * Static value for the header.
+         */
+        value: string;
+      }
+
       /**
        * Set a request header with a static value.
        */
-      export interface StaticHeader {
+      export interface SetStaticHeader {
         operation: 'set';
 
         /**
@@ -9182,10 +9280,22 @@ export declare namespace RuleCreateParams {
         value: string;
       }
 
+      /**
+       * Add a request header with a dynamic value.
+       */
+      export interface AddDynamicHeader {
+        /**
+         * Expression for the header value.
+         */
+        expression: string;
+
+        operation: 'add';
+      }
+
       /**
        * Set a request header with a dynamic value.
        */
-      export interface DynamicHeader {
+      export interface SetDynamicHeader {
         /**
          * Expression for the header value.
          */
@@ -9270,7 +9380,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -9486,7 +9596,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -9666,7 +9776,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -9855,7 +9965,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -10026,10 +10136,10 @@ export declare namespace RuleCreateParams {
       /**
        * Configure the Polish level.
        */
-      polish?: 'off' | 'lossless' | 'lossy';
+      polish?: 'off' | 'lossless' | 'lossy' | 'webp';
 
       /**
-       * Turn on or off Rocket Loader
+       * Turn on or off Rocket Loader.
        */
       rocket_loader?: boolean;
 
@@ -10136,7 +10246,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -10251,7 +10361,7 @@ export declare namespace RuleCreateParams {
     export interface ActionParameters {
       /**
        * A list of phases to skip the execution of. This option is incompatible with the
-       * ruleset and rulesets options.
+       * rulesets option.
        */
       phases?: Array<RulesetsAPI.PhaseParam>;
 
@@ -10268,7 +10378,7 @@ export declare namespace RuleCreateParams {
 
       /**
        * A ruleset to skip the execution of. This option is incompatible with the
-       * rulesets, rules and phases options.
+       * rulesets option.
        */
       ruleset?: 'current';
 
@@ -10339,7 +10449,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -10499,7 +10609,7 @@ export declare namespace RuleCreateParams {
 
       /**
        * Generate Cloudflare error pages from issues sent from the origin server. When
-       * on, error pages will trigger for issues from the origin
+       * on, error pages will trigger for issues from the origin.
        */
       origin_error_page_passthru?: boolean;
 
@@ -10550,13 +10660,13 @@ export declare namespace RuleCreateParams {
        */
       export interface CacheKey {
         /**
-         * Separate cached content based on the visitor’s device type
+         * Separate cached content based on the visitor’s device type.
          */
         cache_by_device_type?: boolean;
 
         /**
          * Protect from web cache deception attacks while allowing static assets to be
-         * cached
+         * cached.
          */
         cache_deception_armor?: boolean;
 
@@ -10780,12 +10890,12 @@ export declare namespace RuleCreateParams {
         default: number;
 
         /**
-         * edge ttl options
+         * Edge TTL options.
          */
         mode: 'respect_origin' | 'bypass_by_default' | 'override_origin';
 
         /**
-         * List of single status codes, or status code ranges to apply the selected mode
+         * List of single status codes, or status code ranges to apply the selected mode.
          */
         status_code_ttl: Array<EdgeTTL.StatusCodeTTL>;
       }
@@ -10793,7 +10903,7 @@ export declare namespace RuleCreateParams {
       export namespace EdgeTTL {
         /**
          * Specify how long Cloudflare should cache the response based on the status code
-         * from the origin. Can be a single status code or a range or status codes
+         * from the origin. Can be a single status code or a range or status codes.
          */
         export interface StatusCodeTTL {
           /**
@@ -10809,7 +10919,7 @@ export declare namespace RuleCreateParams {
           status_code_range?: StatusCodeTTL.StatusCodeRange;
 
           /**
-           * Set the ttl for responses with this specific status code
+           * Set the TTL for responses with this specific status code.
            */
           status_code_value?: number;
         }
@@ -10820,12 +10930,12 @@ export declare namespace RuleCreateParams {
            */
           export interface StatusCodeRange {
             /**
-             * response status code lower bound
+             * Response status code lower bound.
              */
             from: number;
 
             /**
-             * response status code upper bound
+             * Response status code upper bound.
              */
             to: number;
           }
@@ -10907,7 +11017,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -11171,7 +11281,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -11340,7 +11450,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -11512,7 +11622,7 @@ export declare namespace RuleCreateParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -11747,7 +11857,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -11916,7 +12026,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -12043,7 +12153,7 @@ export declare namespace RuleEditParams {
         /**
          * Name of compression algorithm to enable.
          */
-        name?: 'none' | 'auto' | 'default' | 'gzip' | 'brotli';
+        name?: 'none' | 'auto' | 'default' | 'gzip' | 'brotli' | 'zstd';
       }
     }
 
@@ -12107,7 +12217,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -12283,7 +12393,7 @@ export declare namespace RuleEditParams {
 
       export namespace Overrides {
         /**
-         * A category-level override
+         * A category-level override.
          */
         export interface Category {
           /**
@@ -12308,7 +12418,7 @@ export declare namespace RuleEditParams {
         }
 
         /**
-         * A rule-level override
+         * A rule-level override.
          */
         export interface Rule {
           /**
@@ -12399,7 +12509,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -12571,7 +12681,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -12740,7 +12850,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -12912,7 +13022,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -13149,7 +13259,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -13267,7 +13377,11 @@ export declare namespace RuleEditParams {
        */
       headers?: Record<
         string,
-        ActionParameters.RemoveHeader | ActionParameters.StaticHeader | ActionParameters.DynamicHeader
+        | ActionParameters.RemoveHeader
+        | ActionParameters.AddStaticHeader
+        | ActionParameters.SetStaticHeader
+        | ActionParameters.AddDynamicHeader
+        | ActionParameters.SetDynamicHeader
       >;
 
       /**
@@ -13284,10 +13398,22 @@ export declare namespace RuleEditParams {
         operation: 'remove';
       }
 
+      /**
+       * Add a request header with a static value.
+       */
+      export interface AddStaticHeader {
+        operation: 'add';
+
+        /**
+         * Static value for the header.
+         */
+        value: string;
+      }
+
       /**
        * Set a request header with a static value.
        */
-      export interface StaticHeader {
+      export interface SetStaticHeader {
         operation: 'set';
 
         /**
@@ -13296,10 +13422,22 @@ export declare namespace RuleEditParams {
         value: string;
       }
 
+      /**
+       * Add a request header with a dynamic value.
+       */
+      export interface AddDynamicHeader {
+        /**
+         * Expression for the header value.
+         */
+        expression: string;
+
+        operation: 'add';
+      }
+
       /**
        * Set a request header with a dynamic value.
        */
-      export interface DynamicHeader {
+      export interface SetDynamicHeader {
         /**
          * Expression for the header value.
          */
@@ -13384,7 +13522,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -13600,7 +13738,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -13780,7 +13918,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -13969,7 +14107,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -14140,10 +14278,10 @@ export declare namespace RuleEditParams {
       /**
        * Configure the Polish level.
        */
-      polish?: 'off' | 'lossless' | 'lossy';
+      polish?: 'off' | 'lossless' | 'lossy' | 'webp';
 
       /**
-       * Turn on or off Rocket Loader
+       * Turn on or off Rocket Loader.
        */
       rocket_loader?: boolean;
 
@@ -14250,7 +14388,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -14365,7 +14503,7 @@ export declare namespace RuleEditParams {
     export interface ActionParameters {
       /**
        * A list of phases to skip the execution of. This option is incompatible with the
-       * ruleset and rulesets options.
+       * rulesets option.
        */
       phases?: Array<RulesetsAPI.PhaseParam>;
 
@@ -14382,7 +14520,7 @@ export declare namespace RuleEditParams {
 
       /**
        * A ruleset to skip the execution of. This option is incompatible with the
-       * rulesets, rules and phases options.
+       * rulesets option.
        */
       ruleset?: 'current';
 
@@ -14453,7 +14591,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -14613,7 +14751,7 @@ export declare namespace RuleEditParams {
 
       /**
        * Generate Cloudflare error pages from issues sent from the origin server. When
-       * on, error pages will trigger for issues from the origin
+       * on, error pages will trigger for issues from the origin.
        */
       origin_error_page_passthru?: boolean;
 
@@ -14664,13 +14802,13 @@ export declare namespace RuleEditParams {
        */
       export interface CacheKey {
         /**
-         * Separate cached content based on the visitor’s device type
+         * Separate cached content based on the visitor’s device type.
          */
         cache_by_device_type?: boolean;
 
         /**
          * Protect from web cache deception attacks while allowing static assets to be
-         * cached
+         * cached.
          */
         cache_deception_armor?: boolean;
 
@@ -14894,12 +15032,12 @@ export declare namespace RuleEditParams {
         default: number;
 
         /**
-         * edge ttl options
+         * Edge TTL options.
          */
         mode: 'respect_origin' | 'bypass_by_default' | 'override_origin';
 
         /**
-         * List of single status codes, or status code ranges to apply the selected mode
+         * List of single status codes, or status code ranges to apply the selected mode.
          */
         status_code_ttl: Array<EdgeTTL.StatusCodeTTL>;
       }
@@ -14907,7 +15045,7 @@ export declare namespace RuleEditParams {
       export namespace EdgeTTL {
         /**
          * Specify how long Cloudflare should cache the response based on the status code
-         * from the origin. Can be a single status code or a range or status codes
+         * from the origin. Can be a single status code or a range or status codes.
          */
         export interface StatusCodeTTL {
           /**
@@ -14923,7 +15061,7 @@ export declare namespace RuleEditParams {
           status_code_range?: StatusCodeTTL.StatusCodeRange;
 
           /**
-           * Set the ttl for responses with this specific status code
+           * Set the TTL for responses with this specific status code.
            */
           status_code_value?: number;
         }
@@ -14934,12 +15072,12 @@ export declare namespace RuleEditParams {
            */
           export interface StatusCodeRange {
             /**
-             * response status code lower bound
+             * Response status code lower bound.
              */
             from: number;
 
             /**
-             * response status code upper bound
+             * Response status code upper bound.
              */
             to: number;
           }
@@ -15021,7 +15159,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -15285,7 +15423,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -15454,7 +15592,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and
@@ -15626,7 +15764,7 @@ export declare namespace RuleEditParams {
       /**
        * Period in seconds over which the counter is being incremented.
        */
-      period: 10 | 60 | 600 | 3600;
+      period: number;
 
       /**
        * Defines when the ratelimit counter should be incremented. It is optional and