cloudflare 6.0.0-beta.1 → 6.0.0

package/src/resources/rulesets/phases/phases.ts

@@ -160,7 +160,9 @@ export interface PhaseUpdateResponse {
     | RulesAPI.RouteRule
     | RulesAPI.ScoreRule
     | RulesAPI.ServeErrorRule
+    | PhaseUpdateResponse.RulesetsSetCacheControlRule
     | RulesAPI.SetCacheSettingsRule
+    | PhaseUpdateResponse.RulesetsSetCacheTagsRule
     | RulesAPI.SetConfigRule
     | RulesAPI.SkipRule
   >;
@@ -446,84 +448,2130 @@ export namespace PhaseUpdateResponse {
       score_response_header_name?: string;
     }
   }
+
+  export interface RulesetsSetCacheControlRule {
+    /**
+     * The timestamp of when the rule was last modified.
+     */
+    last_updated: string;
+
+    /**
+     * The version of the rule.
+     */
+    version: string;
+
+    /**
+     * The unique ID of the rule.
+     */
+    id?: string;
+
+    /**
+     * The action to perform when the rule matches.
+     */
+    action?: 'set_cache_control';
+
+    /**
+     * The parameters configuring the rule's action.
+     */
+    action_parameters?: RulesetsSetCacheControlRule.ActionParameters;
+
+    /**
+     * The categories of the rule.
+     */
+    categories?: Array<string>;
+
+    /**
+     * An informative description of the rule.
+     */
+    description?: string;
+
+    /**
+     * Whether the rule should be executed.
+     */
+    enabled?: boolean;
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    exposed_credential_check?: RulesetsSetCacheControlRule.ExposedCredentialCheck;
+
+    /**
+     * The expression defining which traffic will match the rule.
+     */
+    expression?: string;
+
+    /**
+     * An object configuring the rule's logging behavior.
+     */
+    logging?: RulesAPI.Logging;
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    ratelimit?: RulesetsSetCacheControlRule.Ratelimit;
+
+    /**
+     * The reference of the rule (the rule's ID by default).
+     */
+    ref?: string;
+  }
+
+  export namespace RulesetsSetCacheControlRule {
+    /**
+     * The parameters configuring the rule's action.
+     */
+    export interface ActionParameters {
+      /**
+       * A cache-control directive configuration.
+       */
+      immutable?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'max-age'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'must-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'must-understand'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts optional qualifiers (header
+       * names).
+       */
+      'no-cache'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'no-store'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'no-transform'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts optional qualifiers (header
+       * names).
+       */
+      private?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'proxy-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      public?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      's-maxage'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'stale-if-error'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'stale-while-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+    }
+
+    export namespace ActionParameters {
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with optional qualifiers.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+
+        /**
+         * Optional list of header names to qualify the directive (e.g., for "private" or
+         * "no-cache" directives).
+         */
+        qualifiers?: Array<string>;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with optional qualifiers.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+
+        /**
+         * Optional list of header names to qualify the directive (e.g., for "private" or
+         * "no-cache" directives).
+         */
+        qualifiers?: Array<string>;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+    }
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    export interface ExposedCredentialCheck {
+      /**
+       * An expression that selects the password used in the credentials check.
+       */
+      password_expression: string;
+
+      /**
+       * An expression that selects the user ID used in the credentials check.
+       */
+      username_expression: string;
+    }
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    export interface Ratelimit {
+      /**
+       * Characteristics of the request on which the rate limit counter will be
+       * incremented.
+       */
+      characteristics: Array<string>;
+
+      /**
+       * Period in seconds over which the counter is being incremented.
+       */
+      period: number;
+
+      /**
+       * An expression that defines when the rate limit counter should be incremented. It
+       * defaults to the same as the rule's expression.
+       */
+      counting_expression?: string;
+
+      /**
+       * Period of time in seconds after which the action will be disabled following its
+       * first execution.
+       */
+      mitigation_timeout?: number;
+
+      /**
+       * The threshold of requests per period after which the action will be executed for
+       * the first time.
+       */
+      requests_per_period?: number;
+
+      /**
+       * Whether counting is only performed when an origin is reached.
+       */
+      requests_to_origin?: boolean;
+
+      /**
+       * The score threshold per period for which the action will be executed the first
+       * time.
+       */
+      score_per_period?: number;
+
+      /**
+       * A response header name provided by the origin, which contains the score to
+       * increment rate limit counter with.
+       */
+      score_response_header_name?: string;
+    }
+  }
+
+  export interface RulesetsSetCacheTagsRule {
+    /**
+     * The timestamp of when the rule was last modified.
+     */
+    last_updated: string;
+
+    /**
+     * The version of the rule.
+     */
+    version: string;
+
+    /**
+     * The unique ID of the rule.
+     */
+    id?: string;
+
+    /**
+     * The action to perform when the rule matches.
+     */
+    action?: 'set_cache_tags';
+
+    /**
+     * The parameters configuring the rule's action.
+     */
+    action_parameters?:
+      | RulesetsSetCacheTagsRule.AddCacheTagsValues
+      | RulesetsSetCacheTagsRule.AddCacheTagsExpression
+      | RulesetsSetCacheTagsRule.RemoveCacheTagsValues
+      | RulesetsSetCacheTagsRule.RemoveCacheTagsExpression
+      | RulesetsSetCacheTagsRule.SetCacheTagsValues
+      | RulesetsSetCacheTagsRule.SetCacheTagsExpression;
+
+    /**
+     * The categories of the rule.
+     */
+    categories?: Array<string>;
+
+    /**
+     * An informative description of the rule.
+     */
+    description?: string;
+
+    /**
+     * Whether the rule should be executed.
+     */
+    enabled?: boolean;
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    exposed_credential_check?: RulesetsSetCacheTagsRule.ExposedCredentialCheck;
+
+    /**
+     * The expression defining which traffic will match the rule.
+     */
+    expression?: string;
+
+    /**
+     * An object configuring the rule's logging behavior.
+     */
+    logging?: RulesAPI.Logging;
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    ratelimit?: RulesetsSetCacheTagsRule.Ratelimit;
+
+    /**
+     * The reference of the rule (the rule's ID by default).
+     */
+    ref?: string;
+  }
+
+  export namespace RulesetsSetCacheTagsRule {
+    /**
+     * Add cache tags using a list of values.
+     */
+    export interface AddCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Add cache tags using an expression.
+     */
+    export interface AddCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
+    /**
+     * Remove cache tags using a list of values.
+     */
+    export interface RemoveCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Remove cache tags using an expression.
+     */
+    export interface RemoveCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
+    /**
+     * Set cache tags using a list of values.
+     */
+    export interface SetCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Set cache tags using an expression.
+     */
+    export interface SetCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    export interface ExposedCredentialCheck {
+      /**
+       * An expression that selects the password used in the credentials check.
+       */
+      password_expression: string;
+
+      /**
+       * An expression that selects the user ID used in the credentials check.
+       */
+      username_expression: string;
+    }
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    export interface Ratelimit {
+      /**
+       * Characteristics of the request on which the rate limit counter will be
+       * incremented.
+       */
+      characteristics: Array<string>;
+
+      /**
+       * Period in seconds over which the counter is being incremented.
+       */
+      period: number;
+
+      /**
+       * An expression that defines when the rate limit counter should be incremented. It
+       * defaults to the same as the rule's expression.
+       */
+      counting_expression?: string;
+
+      /**
+       * Period of time in seconds after which the action will be disabled following its
+       * first execution.
+       */
+      mitigation_timeout?: number;
+
+      /**
+       * The threshold of requests per period after which the action will be executed for
+       * the first time.
+       */
+      requests_per_period?: number;
+
+      /**
+       * Whether counting is only performed when an origin is reached.
+       */
+      requests_to_origin?: boolean;
+
+      /**
+       * The score threshold per period for which the action will be executed the first
+       * time.
+       */
+      score_per_period?: number;
+
+      /**
+       * A response header name provided by the origin, which contains the score to
+       * increment rate limit counter with.
+       */
+      score_response_header_name?: string;
+    }
+  }
+}
+
+/**
+ * A ruleset object.
+ */
+export interface PhaseGetResponse {
+  /**
+   * The unique ID of the ruleset.
+   */
+  id: string;
+
+  /**
+   * The kind of the ruleset.
+   */
+  kind: RulesetsAPI.Kind;
+
+  /**
+   * The timestamp of when the ruleset was last modified.
+   */
+  last_updated: string;
+
+  /**
+   * The human-readable name of the ruleset.
+   */
+  name: string;
+
+  /**
+   * The phase of the ruleset.
+   */
+  phase: RulesetsAPI.Phase;
+
+  /**
+   * The list of rules in the ruleset.
+   */
+  rules: Array<
+    | RulesAPI.BlockRule
+    | PhaseGetResponse.RulesetsChallengeRule
+    | RulesAPI.CompressResponseRule
+    | RulesAPI.DDoSDynamicRule
+    | RulesAPI.ExecuteRule
+    | RulesAPI.ForceConnectionCloseRule
+    | PhaseGetResponse.RulesetsJSChallengeRule
+    | RulesAPI.LogRule
+    | RulesAPI.LogCustomFieldRule
+    | RulesAPI.ManagedChallengeRule
+    | RulesAPI.RedirectRule
+    | RulesAPI.RewriteRule
+    | RulesAPI.RouteRule
+    | RulesAPI.ScoreRule
+    | RulesAPI.ServeErrorRule
+    | PhaseGetResponse.RulesetsSetCacheControlRule
+    | RulesAPI.SetCacheSettingsRule
+    | PhaseGetResponse.RulesetsSetCacheTagsRule
+    | RulesAPI.SetConfigRule
+    | RulesAPI.SkipRule
+  >;
+
+  /**
+   * The version of the ruleset.
+   */
+  version: string;
+
+  /**
+   * An informative description of the ruleset.
+   */
+  description?: string;
 }
 
-/**
- * A ruleset object.
- */
-export interface PhaseGetResponse {
-  /**
-   * The unique ID of the ruleset.
-   */
-  id: string;
+export namespace PhaseGetResponse {
+  export interface RulesetsChallengeRule {
+    /**
+     * The timestamp of when the rule was last modified.
+     */
+    last_updated: string;
+
+    /**
+     * The version of the rule.
+     */
+    version: string;
+
+    /**
+     * The unique ID of the rule.
+     */
+    id?: string;
+
+    /**
+     * The action to perform when the rule matches.
+     */
+    action?: 'challenge';
+
+    /**
+     * The parameters configuring the rule's action.
+     */
+    action_parameters?: unknown;
+
+    /**
+     * The categories of the rule.
+     */
+    categories?: Array<string>;
+
+    /**
+     * An informative description of the rule.
+     */
+    description?: string;
+
+    /**
+     * Whether the rule should be executed.
+     */
+    enabled?: boolean;
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    exposed_credential_check?: RulesetsChallengeRule.ExposedCredentialCheck;
+
+    /**
+     * The expression defining which traffic will match the rule.
+     */
+    expression?: string;
+
+    /**
+     * An object configuring the rule's logging behavior.
+     */
+    logging?: RulesAPI.Logging;
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    ratelimit?: RulesetsChallengeRule.Ratelimit;
+
+    /**
+     * The reference of the rule (the rule's ID by default).
+     */
+    ref?: string;
+  }
+
+  export namespace RulesetsChallengeRule {
+    /**
+     * Configuration for exposed credential checking.
+     */
+    export interface ExposedCredentialCheck {
+      /**
+       * An expression that selects the password used in the credentials check.
+       */
+      password_expression: string;
+
+      /**
+       * An expression that selects the user ID used in the credentials check.
+       */
+      username_expression: string;
+    }
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    export interface Ratelimit {
+      /**
+       * Characteristics of the request on which the rate limit counter will be
+       * incremented.
+       */
+      characteristics: Array<string>;
+
+      /**
+       * Period in seconds over which the counter is being incremented.
+       */
+      period: number;
+
+      /**
+       * An expression that defines when the rate limit counter should be incremented. It
+       * defaults to the same as the rule's expression.
+       */
+      counting_expression?: string;
+
+      /**
+       * Period of time in seconds after which the action will be disabled following its
+       * first execution.
+       */
+      mitigation_timeout?: number;
+
+      /**
+       * The threshold of requests per period after which the action will be executed for
+       * the first time.
+       */
+      requests_per_period?: number;
+
+      /**
+       * Whether counting is only performed when an origin is reached.
+       */
+      requests_to_origin?: boolean;
+
+      /**
+       * The score threshold per period for which the action will be executed the first
+       * time.
+       */
+      score_per_period?: number;
+
+      /**
+       * A response header name provided by the origin, which contains the score to
+       * increment rate limit counter with.
+       */
+      score_response_header_name?: string;
+    }
+  }
+
+  export interface RulesetsJSChallengeRule {
+    /**
+     * The timestamp of when the rule was last modified.
+     */
+    last_updated: string;
+
+    /**
+     * The version of the rule.
+     */
+    version: string;
+
+    /**
+     * The unique ID of the rule.
+     */
+    id?: string;
+
+    /**
+     * The action to perform when the rule matches.
+     */
+    action?: 'js_challenge';
+
+    /**
+     * The parameters configuring the rule's action.
+     */
+    action_parameters?: unknown;
+
+    /**
+     * The categories of the rule.
+     */
+    categories?: Array<string>;
+
+    /**
+     * An informative description of the rule.
+     */
+    description?: string;
+
+    /**
+     * Whether the rule should be executed.
+     */
+    enabled?: boolean;
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    exposed_credential_check?: RulesetsJSChallengeRule.ExposedCredentialCheck;
+
+    /**
+     * The expression defining which traffic will match the rule.
+     */
+    expression?: string;
+
+    /**
+     * An object configuring the rule's logging behavior.
+     */
+    logging?: RulesAPI.Logging;
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    ratelimit?: RulesetsJSChallengeRule.Ratelimit;
+
+    /**
+     * The reference of the rule (the rule's ID by default).
+     */
+    ref?: string;
+  }
+
+  export namespace RulesetsJSChallengeRule {
+    /**
+     * Configuration for exposed credential checking.
+     */
+    export interface ExposedCredentialCheck {
+      /**
+       * An expression that selects the password used in the credentials check.
+       */
+      password_expression: string;
+
+      /**
+       * An expression that selects the user ID used in the credentials check.
+       */
+      username_expression: string;
+    }
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    export interface Ratelimit {
+      /**
+       * Characteristics of the request on which the rate limit counter will be
+       * incremented.
+       */
+      characteristics: Array<string>;
+
+      /**
+       * Period in seconds over which the counter is being incremented.
+       */
+      period: number;
+
+      /**
+       * An expression that defines when the rate limit counter should be incremented. It
+       * defaults to the same as the rule's expression.
+       */
+      counting_expression?: string;
+
+      /**
+       * Period of time in seconds after which the action will be disabled following its
+       * first execution.
+       */
+      mitigation_timeout?: number;
+
+      /**
+       * The threshold of requests per period after which the action will be executed for
+       * the first time.
+       */
+      requests_per_period?: number;
+
+      /**
+       * Whether counting is only performed when an origin is reached.
+       */
+      requests_to_origin?: boolean;
+
+      /**
+       * The score threshold per period for which the action will be executed the first
+       * time.
+       */
+      score_per_period?: number;
+
+      /**
+       * A response header name provided by the origin, which contains the score to
+       * increment rate limit counter with.
+       */
+      score_response_header_name?: string;
+    }
+  }
+
+  export interface RulesetsSetCacheControlRule {
+    /**
+     * The timestamp of when the rule was last modified.
+     */
+    last_updated: string;
+
+    /**
+     * The version of the rule.
+     */
+    version: string;
+
+    /**
+     * The unique ID of the rule.
+     */
+    id?: string;
+
+    /**
+     * The action to perform when the rule matches.
+     */
+    action?: 'set_cache_control';
+
+    /**
+     * The parameters configuring the rule's action.
+     */
+    action_parameters?: RulesetsSetCacheControlRule.ActionParameters;
+
+    /**
+     * The categories of the rule.
+     */
+    categories?: Array<string>;
+
+    /**
+     * An informative description of the rule.
+     */
+    description?: string;
+
+    /**
+     * Whether the rule should be executed.
+     */
+    enabled?: boolean;
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    exposed_credential_check?: RulesetsSetCacheControlRule.ExposedCredentialCheck;
+
+    /**
+     * The expression defining which traffic will match the rule.
+     */
+    expression?: string;
+
+    /**
+     * An object configuring the rule's logging behavior.
+     */
+    logging?: RulesAPI.Logging;
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    ratelimit?: RulesetsSetCacheControlRule.Ratelimit;
+
+    /**
+     * The reference of the rule (the rule's ID by default).
+     */
+    ref?: string;
+  }
+
+  export namespace RulesetsSetCacheControlRule {
+    /**
+     * The parameters configuring the rule's action.
+     */
+    export interface ActionParameters {
+      /**
+       * A cache-control directive configuration.
+       */
+      immutable?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'max-age'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'must-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'must-understand'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts optional qualifiers (header
+       * names).
+       */
+      'no-cache'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'no-store'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'no-transform'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts optional qualifiers (header
+       * names).
+       */
+      private?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'proxy-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      public?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      's-maxage'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'stale-if-error'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'stale-while-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+    }
+
+    export namespace ActionParameters {
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with optional qualifiers.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+
+        /**
+         * Optional list of header names to qualify the directive (e.g., for "private" or
+         * "no-cache" directives).
+         */
+        qualifiers?: Array<string>;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with optional qualifiers.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+
+        /**
+         * Optional list of header names to qualify the directive (e.g., for "private" or
+         * "no-cache" directives).
+         */
+        qualifiers?: Array<string>;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+    }
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    export interface ExposedCredentialCheck {
+      /**
+       * An expression that selects the password used in the credentials check.
+       */
+      password_expression: string;
+
+      /**
+       * An expression that selects the user ID used in the credentials check.
+       */
+      username_expression: string;
+    }
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    export interface Ratelimit {
+      /**
+       * Characteristics of the request on which the rate limit counter will be
+       * incremented.
+       */
+      characteristics: Array<string>;
+
+      /**
+       * Period in seconds over which the counter is being incremented.
+       */
+      period: number;
+
+      /**
+       * An expression that defines when the rate limit counter should be incremented. It
+       * defaults to the same as the rule's expression.
+       */
+      counting_expression?: string;
+
+      /**
+       * Period of time in seconds after which the action will be disabled following its
+       * first execution.
+       */
+      mitigation_timeout?: number;
+
+      /**
+       * The threshold of requests per period after which the action will be executed for
+       * the first time.
+       */
+      requests_per_period?: number;
+
+      /**
+       * Whether counting is only performed when an origin is reached.
+       */
+      requests_to_origin?: boolean;
+
+      /**
+       * The score threshold per period for which the action will be executed the first
+       * time.
+       */
+      score_per_period?: number;
+
+      /**
+       * A response header name provided by the origin, which contains the score to
+       * increment rate limit counter with.
+       */
+      score_response_header_name?: string;
+    }
+  }
+
+  export interface RulesetsSetCacheTagsRule {
+    /**
+     * The timestamp of when the rule was last modified.
+     */
+    last_updated: string;
+
+    /**
+     * The version of the rule.
+     */
+    version: string;
+
+    /**
+     * The unique ID of the rule.
+     */
+    id?: string;
+
+    /**
+     * The action to perform when the rule matches.
+     */
+    action?: 'set_cache_tags';
+
+    /**
+     * The parameters configuring the rule's action.
+     */
+    action_parameters?:
+      | RulesetsSetCacheTagsRule.AddCacheTagsValues
+      | RulesetsSetCacheTagsRule.AddCacheTagsExpression
+      | RulesetsSetCacheTagsRule.RemoveCacheTagsValues
+      | RulesetsSetCacheTagsRule.RemoveCacheTagsExpression
+      | RulesetsSetCacheTagsRule.SetCacheTagsValues
+      | RulesetsSetCacheTagsRule.SetCacheTagsExpression;
+
+    /**
+     * The categories of the rule.
+     */
+    categories?: Array<string>;
 
-  /**
-   * The kind of the ruleset.
-   */
-  kind: RulesetsAPI.Kind;
+    /**
+     * An informative description of the rule.
+     */
+    description?: string;
 
-  /**
-   * The timestamp of when the ruleset was last modified.
-   */
-  last_updated: string;
+    /**
+     * Whether the rule should be executed.
+     */
+    enabled?: boolean;
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    exposed_credential_check?: RulesetsSetCacheTagsRule.ExposedCredentialCheck;
+
+    /**
+     * The expression defining which traffic will match the rule.
+     */
+    expression?: string;
+
+    /**
+     * An object configuring the rule's logging behavior.
+     */
+    logging?: RulesAPI.Logging;
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    ratelimit?: RulesetsSetCacheTagsRule.Ratelimit;
+
+    /**
+     * The reference of the rule (the rule's ID by default).
+     */
+    ref?: string;
+  }
+
+  export namespace RulesetsSetCacheTagsRule {
+    /**
+     * Add cache tags using a list of values.
+     */
+    export interface AddCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Add cache tags using an expression.
+     */
+    export interface AddCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
+    /**
+     * Remove cache tags using a list of values.
+     */
+    export interface RemoveCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Remove cache tags using an expression.
+     */
+    export interface RemoveCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
+    /**
+     * Set cache tags using a list of values.
+     */
+    export interface SetCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Set cache tags using an expression.
+     */
+    export interface SetCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
+    /**
+     * Configuration for exposed credential checking.
+     */
+    export interface ExposedCredentialCheck {
+      /**
+       * An expression that selects the password used in the credentials check.
+       */
+      password_expression: string;
+
+      /**
+       * An expression that selects the user ID used in the credentials check.
+       */
+      username_expression: string;
+    }
+
+    /**
+     * An object configuring the rule's rate limit behavior.
+     */
+    export interface Ratelimit {
+      /**
+       * Characteristics of the request on which the rate limit counter will be
+       * incremented.
+       */
+      characteristics: Array<string>;
+
+      /**
+       * Period in seconds over which the counter is being incremented.
+       */
+      period: number;
+
+      /**
+       * An expression that defines when the rate limit counter should be incremented. It
+       * defaults to the same as the rule's expression.
+       */
+      counting_expression?: string;
+
+      /**
+       * Period of time in seconds after which the action will be disabled following its
+       * first execution.
+       */
+      mitigation_timeout?: number;
+
+      /**
+       * The threshold of requests per period after which the action will be executed for
+       * the first time.
+       */
+      requests_per_period?: number;
+
+      /**
+       * Whether counting is only performed when an origin is reached.
+       */
+      requests_to_origin?: boolean;
+
+      /**
+       * The score threshold per period for which the action will be executed the first
+       * time.
+       */
+      score_per_period?: number;
+
+      /**
+       * A response header name provided by the origin, which contains the score to
+       * increment rate limit counter with.
+       */
+      score_response_header_name?: string;
+    }
+  }
+}
 
+export interface PhaseUpdateParams {
   /**
-   * The human-readable name of the ruleset.
+   * Path param: The Account ID to use for this endpoint. Mutually exclusive with the
+   * Zone ID.
    */
-  name: string;
+  account_id?: string;
 
   /**
-   * The phase of the ruleset.
+   * Path param: The Zone ID to use for this endpoint. Mutually exclusive with the
+   * Account ID.
    */
-  phase: RulesetsAPI.Phase;
+  zone_id?: string;
 
   /**
-   * The list of rules in the ruleset.
+   * Body param: An informative description of the ruleset.
    */
-  rules: Array<
-    | RulesAPI.BlockRule
-    | PhaseGetResponse.RulesetsChallengeRule
-    | RulesAPI.CompressResponseRule
-    | RulesAPI.DDoSDynamicRule
-    | RulesAPI.ExecuteRule
-    | RulesAPI.ForceConnectionCloseRule
-    | PhaseGetResponse.RulesetsJSChallengeRule
-    | RulesAPI.LogRule
-    | RulesAPI.LogCustomFieldRule
-    | RulesAPI.ManagedChallengeRule
-    | RulesAPI.RedirectRule
-    | RulesAPI.RewriteRule
-    | RulesAPI.RouteRule
-    | RulesAPI.ScoreRule
-    | RulesAPI.ServeErrorRule
-    | RulesAPI.SetCacheSettingsRule
-    | RulesAPI.SetConfigRule
-    | RulesAPI.SkipRule
-  >;
+  description?: string;
 
   /**
-   * The version of the ruleset.
+   * Body param: The human-readable name of the ruleset.
    */
-  version: string;
+  name?: string;
 
   /**
-   * An informative description of the ruleset.
+   * Body param: The list of rules in the ruleset.
    */
-  description?: string;
+  rules?: Array<
+    | RulesAPI.BlockRuleParam
+    | PhaseUpdateParams.RulesetsChallengeRule
+    | RulesAPI.CompressResponseRuleParam
+    | RulesAPI.DDoSDynamicRuleParam
+    | RulesAPI.ExecuteRuleParam
+    | RulesAPI.ForceConnectionCloseRuleParam
+    | PhaseUpdateParams.RulesetsJSChallengeRule
+    | RulesAPI.LogRuleParam
+    | RulesAPI.LogCustomFieldRuleParam
+    | RulesAPI.ManagedChallengeRuleParam
+    | RulesAPI.RedirectRuleParam
+    | RulesAPI.RewriteRuleParam
+    | RulesAPI.RouteRuleParam
+    | RulesAPI.ScoreRuleParam
+    | RulesAPI.ServeErrorRuleParam
+    | PhaseUpdateParams.RulesetsSetCacheControlRule
+    | RulesAPI.SetCacheSettingsRuleParam
+    | PhaseUpdateParams.RulesetsSetCacheTagsRule
+    | RulesAPI.SetConfigRuleParam
+    | RulesAPI.SkipRuleParam
+  >;
 }
 
-export namespace PhaseGetResponse {
+export namespace PhaseUpdateParams {
   export interface RulesetsChallengeRule {
-    /**
-     * The timestamp of when the rule was last modified.
-     */
-    last_updated: string;
-
-    /**
-     * The version of the rule.
-     */
-    version: string;
-
     /**
      * The unique ID of the rule.
      */
@@ -539,11 +2587,6 @@ export namespace PhaseGetResponse {
      */
     action_parameters?: unknown;
 
-    /**
-     * The categories of the rule.
-     */
-    categories?: Array<string>;
-
     /**
      * An informative description of the rule.
      */
@@ -567,7 +2610,7 @@ export namespace PhaseGetResponse {
     /**
      * An object configuring the rule's logging behavior.
      */
-    logging?: RulesAPI.Logging;
+    logging?: RulesAPI.LoggingParam;
 
     /**
      * An object configuring the rule's rate limit behavior.
@@ -649,16 +2692,6 @@ export namespace PhaseGetResponse {
   }
 
   export interface RulesetsJSChallengeRule {
-    /**
-     * The timestamp of when the rule was last modified.
-     */
-    last_updated: string;
-
-    /**
-     * The version of the rule.
-     */
-    version: string;
-
     /**
      * The unique ID of the rule.
      */
@@ -674,11 +2707,6 @@ export namespace PhaseGetResponse {
      */
     action_parameters?: unknown;
 
-    /**
-     * The categories of the rule.
-     */
-    categories?: Array<string>;
-
     /**
      * An informative description of the rule.
      */
@@ -702,7 +2730,7 @@ export namespace PhaseGetResponse {
     /**
      * An object configuring the rule's logging behavior.
      */
-    logging?: RulesAPI.Logging;
+    logging?: RulesAPI.LoggingParam;
 
     /**
      * An object configuring the rule's rate limit behavior.
@@ -782,58 +2810,8 @@ export namespace PhaseGetResponse {
       score_response_header_name?: string;
     }
   }
-}
-
-export interface PhaseUpdateParams {
-  /**
-   * Path param: The Account ID to use for this endpoint. Mutually exclusive with the
-   * Zone ID.
-   */
-  account_id?: string;
-
-  /**
-   * Path param: The Zone ID to use for this endpoint. Mutually exclusive with the
-   * Account ID.
-   */
-  zone_id?: string;
-
-  /**
-   * Body param: An informative description of the ruleset.
-   */
-  description?: string;
-
-  /**
-   * Body param: The human-readable name of the ruleset.
-   */
-  name?: string;
-
-  /**
-   * Body param: The list of rules in the ruleset.
-   */
-  rules?: Array<
-    | RulesAPI.BlockRuleParam
-    | PhaseUpdateParams.RulesetsChallengeRule
-    | RulesAPI.CompressResponseRuleParam
-    | RulesAPI.DDoSDynamicRuleParam
-    | RulesAPI.ExecuteRuleParam
-    | RulesAPI.ForceConnectionCloseRuleParam
-    | PhaseUpdateParams.RulesetsJSChallengeRule
-    | RulesAPI.LogRuleParam
-    | RulesAPI.LogCustomFieldRuleParam
-    | RulesAPI.ManagedChallengeRuleParam
-    | RulesAPI.RedirectRuleParam
-    | RulesAPI.RewriteRuleParam
-    | RulesAPI.RouteRuleParam
-    | RulesAPI.ScoreRuleParam
-    | RulesAPI.ServeErrorRuleParam
-    | RulesAPI.SetCacheSettingsRuleParam
-    | RulesAPI.SetConfigRuleParam
-    | RulesAPI.SkipRuleParam
-  >;
-}
 
-export namespace PhaseUpdateParams {
-  export interface RulesetsChallengeRule {
+  export interface RulesetsSetCacheControlRule {
     /**
      * The unique ID of the rule.
      */
@@ -842,12 +2820,12 @@ export namespace PhaseUpdateParams {
     /**
      * The action to perform when the rule matches.
      */
-    action?: 'challenge';
+    action?: 'set_cache_control';
 
     /**
      * The parameters configuring the rule's action.
      */
-    action_parameters?: unknown;
+    action_parameters?: RulesetsSetCacheControlRule.ActionParameters;
 
     /**
      * An informative description of the rule.
@@ -862,7 +2840,7 @@ export namespace PhaseUpdateParams {
     /**
      * Configuration for exposed credential checking.
      */
-    exposed_credential_check?: RulesetsChallengeRule.ExposedCredentialCheck;
+    exposed_credential_check?: RulesetsSetCacheControlRule.ExposedCredentialCheck;
 
     /**
      * The expression defining which traffic will match the rule.
@@ -877,7 +2855,7 @@ export namespace PhaseUpdateParams {
     /**
      * An object configuring the rule's rate limit behavior.
      */
-    ratelimit?: RulesetsChallengeRule.Ratelimit;
+    ratelimit?: RulesetsSetCacheControlRule.Ratelimit;
 
     /**
      * The reference of the rule (the rule's ID by default).
@@ -885,7 +2863,507 @@ export namespace PhaseUpdateParams {
     ref?: string;
   }
 
-  export namespace RulesetsChallengeRule {
+  export namespace RulesetsSetCacheControlRule {
+    /**
+     * The parameters configuring the rule's action.
+     */
+    export interface ActionParameters {
+      /**
+       * A cache-control directive configuration.
+       */
+      immutable?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'max-age'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'must-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'must-understand'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts optional qualifiers (header
+       * names).
+       */
+      'no-cache'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'no-store'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'no-transform'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts optional qualifiers (header
+       * names).
+       */
+      private?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      'proxy-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration.
+       */
+      public?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      's-maxage'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'stale-if-error'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+
+      /**
+       * A cache-control directive configuration that accepts a duration value in
+       * seconds.
+       */
+      'stale-while-revalidate'?: ActionParameters.SetDirective | ActionParameters.RemoveDirective;
+    }
+
+    export namespace ActionParameters {
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with optional qualifiers.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+
+        /**
+         * Optional list of header names to qualify the directive (e.g., for "private" or
+         * "no-cache" directives).
+         */
+        qualifiers?: Array<string>;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with optional qualifiers.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+
+        /**
+         * Optional list of header names to qualify the directive (e.g., for "private" or
+         * "no-cache" directives).
+         */
+        qualifiers?: Array<string>;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Set the directive with a duration value in seconds.
+       */
+      export interface SetDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * The duration value in seconds for the directive.
+         */
+        value: number;
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+
+      /**
+       * Remove the directive.
+       */
+      export interface RemoveDirective {
+        /**
+         * The operation to perform on the cache-control directive.
+         */
+        operation: 'set' | 'remove';
+
+        /**
+         * Whether the directive should only be applied to the Cloudflare CDN cache.
+         */
+        cloudflare_only?: boolean;
+      }
+    }
+
     /**
      * Configuration for exposed credential checking.
      */
@@ -953,7 +3431,7 @@ export namespace PhaseUpdateParams {
     }
   }
 
-  export interface RulesetsJSChallengeRule {
+  export interface RulesetsSetCacheTagsRule {
     /**
      * The unique ID of the rule.
      */
@@ -962,12 +3440,18 @@ export namespace PhaseUpdateParams {
     /**
      * The action to perform when the rule matches.
      */
-    action?: 'js_challenge';
+    action?: 'set_cache_tags';
 
     /**
      * The parameters configuring the rule's action.
      */
-    action_parameters?: unknown;
+    action_parameters?:
+      | RulesetsSetCacheTagsRule.AddCacheTagsValues
+      | RulesetsSetCacheTagsRule.AddCacheTagsExpression
+      | RulesetsSetCacheTagsRule.RemoveCacheTagsValues
+      | RulesetsSetCacheTagsRule.RemoveCacheTagsExpression
+      | RulesetsSetCacheTagsRule.SetCacheTagsValues
+      | RulesetsSetCacheTagsRule.SetCacheTagsExpression;
 
     /**
      * An informative description of the rule.
@@ -982,7 +3466,7 @@ export namespace PhaseUpdateParams {
     /**
      * Configuration for exposed credential checking.
      */
-    exposed_credential_check?: RulesetsJSChallengeRule.ExposedCredentialCheck;
+    exposed_credential_check?: RulesetsSetCacheTagsRule.ExposedCredentialCheck;
 
     /**
      * The expression defining which traffic will match the rule.
@@ -997,7 +3481,7 @@ export namespace PhaseUpdateParams {
     /**
      * An object configuring the rule's rate limit behavior.
      */
-    ratelimit?: RulesetsJSChallengeRule.Ratelimit;
+    ratelimit?: RulesetsSetCacheTagsRule.Ratelimit;
 
     /**
      * The reference of the rule (the rule's ID by default).
@@ -1005,7 +3489,97 @@ export namespace PhaseUpdateParams {
     ref?: string;
   }
 
-  export namespace RulesetsJSChallengeRule {
+  export namespace RulesetsSetCacheTagsRule {
+    /**
+     * Add cache tags using a list of values.
+     */
+    export interface AddCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Add cache tags using an expression.
+     */
+    export interface AddCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
+    /**
+     * Remove cache tags using a list of values.
+     */
+    export interface RemoveCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Remove cache tags using an expression.
+     */
+    export interface RemoveCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
+    /**
+     * Set cache tags using a list of values.
+     */
+    export interface SetCacheTagsValues {
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+
+      /**
+       * A list of cache tag values.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Set cache tags using an expression.
+     */
+    export interface SetCacheTagsExpression {
+      /**
+       * An expression that evaluates to an array of cache tag values.
+       */
+      expression: string;
+
+      /**
+       * The operation to perform on the cache tags.
+       */
+      operation: 'add' | 'remove' | 'set';
+    }
+
     /**
      * Configuration for exposed credential checking.
      */