cloudflare 4.1.0 → 4.2.0

package/resources/radar/http/timeseries-groups.d.ts

@@ -2,60 +2,55 @@ import { APIResource } from "../../../resource.js";
 import * as Core from "../../../core.js";
 export declare class TimeseriesGroups extends APIResource {
     /**
-     * Get a time series of the percentage distribution of traffic classified as
-     * automated or human. Visit
-     * https://developers.cloudflare.com/radar/concepts/bot-classes/ for more
-     * information.
+     * Retrieves the distribution of HTTP requests classified as automated or human
+     * over time. Visit https://developers.cloudflare.com/radar/concepts/bot-classes/
+     * for more information.
      */
     botClass(query?: TimeseriesGroupBotClassParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupBotClassResponse>;
     botClass(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupBotClassResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic of the top user
-     * agents.
+     * Retrieves the distribution of HTTP requests by user agent over time.
      */
     browser(query?: TimeseriesGroupBrowserParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupBrowserResponse>;
     browser(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupBrowserResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic of the top user
-     * agents aggregated in families.
+     * Retrieves the distribution of HTTP requests by user agent family over time.
      */
     browserFamily(query?: TimeseriesGroupBrowserFamilyParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupBrowserFamilyResponse>;
     browserFamily(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupBrowserFamilyResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic by device type.
+     * Retrieves the distribution of HTTP requests by device type over time.
      */
     deviceType(query?: TimeseriesGroupDeviceTypeParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupDeviceTypeResponse>;
     deviceType(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupDeviceTypeResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic by HTTP protocol.
+     * Retrieves the distribution of HTTP requests by HTTP protocol (HTTP vs. HTTPS)
+     * over time.
      */
     httpProtocol(query?: TimeseriesGroupHTTPProtocolParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupHTTPProtocolResponse>;
     httpProtocol(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupHTTPProtocolResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic by HTTP version.
+     * Retrieves the distribution of HTTP requests by HTTP version over time.
      */
     httpVersion(query?: TimeseriesGroupHTTPVersionParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupHTTPVersionResponse>;
     httpVersion(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupHTTPVersionResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic by IP version.
+     * Retrieves the distribution of HTTP requests by IP version over time.
      */
     ipVersion(query?: TimeseriesGroupIPVersionParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupIPVersionResponse>;
     ipVersion(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupIPVersionResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic of the top operating
-     * systems.
+     * Retrieves the distribution of HTTP requests by operating system over time.
      */
     os(query?: TimeseriesGroupOSParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupOSResponse>;
     os(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupOSResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic by post-quantum
-     * suport.
+     * Retrieves the distribution of HTTP requests by post-quantum support over time.
      */
     postQuantum(query?: TimeseriesGroupPostQuantumParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupPostQuantumResponse>;
     postQuantum(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupPostQuantumResponse>;
     /**
-     * Get a time series of the percentage distribution of traffic by TLS protocol
-     * version.
+     * Retrieves the distribution of HTTP requests by TLS version over time.
      */
     tlsVersion(query?: TimeseriesGroupTLSVersionParams, options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupTLSVersionResponse>;
     tlsVersion(options?: Core.RequestOptions): Core.APIPromise<TimeseriesGroupTLSVersionResponse>;
@@ -180,15 +175,19 @@ export interface TimeseriesGroupBotClassParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -196,51 +195,51 @@ export interface TimeseriesGroupBotClassParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -252,20 +251,24 @@ export interface TimeseriesGroupBrowserParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -273,56 +276,58 @@ export interface TimeseriesGroupBrowserParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Limit the number of objects (eg browsers, verticals, etc) to the top items over
-     * the time range.
+     * Limits the number of objects per group to the top items within the specified
+     * time range. If there are more items than the limit, the response will include
+     * the count of items, with any remaining items grouped together under an "other"
+     * category.
      */
     limitPerGroup?: number;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -334,20 +339,20 @@ export interface TimeseriesGroupBrowserFamilyParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -355,56 +360,58 @@ export interface TimeseriesGroupBrowserFamilyParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Limit the number of objects (eg browsers, verticals, etc) to the top items over
-     * the time range.
+     * Limits the number of objects per group to the top items within the specified
+     * time range. If there are more items than the limit, the response will include
+     * the count of items, with any remaining items grouped together under an "other"
+     * category.
      */
     limitPerGroup?: number;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -416,20 +423,24 @@ export interface TimeseriesGroupDeviceTypeParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -437,47 +448,47 @@ export interface TimeseriesGroupDeviceTypeParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -489,20 +500,24 @@ export interface TimeseriesGroupHTTPProtocolParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -510,47 +525,47 @@ export interface TimeseriesGroupHTTPProtocolParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -562,20 +577,24 @@ export interface TimeseriesGroupHTTPVersionParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -583,47 +602,47 @@ export interface TimeseriesGroupHTTPVersionParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -635,20 +654,24 @@ export interface TimeseriesGroupIPVersionParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -656,47 +679,47 @@ export interface TimeseriesGroupIPVersionParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -708,20 +731,24 @@ export interface TimeseriesGroupOSParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -729,47 +756,47 @@ export interface TimeseriesGroupOSParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -781,20 +808,24 @@ export interface TimeseriesGroupPostQuantumParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -802,51 +833,51 @@ export interface TimeseriesGroupPostQuantumParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
     /**
-     * Filter for tls version.
+     * Filters results by TLS version.
      */
     tlsVersion?: Array<'TLSv1_0' | 'TLSv1_1' | 'TLSv1_2' | 'TLSv1_3' | 'TLSvQUIC'>;
 }
@@ -858,20 +889,24 @@ export interface TimeseriesGroupTLSVersionParams {
      */
     aggInterval?: '15m' | '1h' | '1d' | '1w';
     /**
-     * Array of comma separated list of ASNs, start with `-` to exclude from results.
-     * For example, `-174, 3356` excludes results from AS174, but includes results from
-     * AS3356.
+     * Comma-separated list of Autonomous System Numbers (ASNs). Prefix with `-` to
+     * exclude ASNs from results. For example, `-174, 3356` excludes results from
+     * AS174, but includes results from AS3356.
      */
     asn?: Array<string>;
     /**
-     * Filter for bot class. Refer to
+     * Filters results by bot class. Refer to
      * [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/).
      */
     botClass?: Array<'LIKELY_AUTOMATED' | 'LIKELY_HUMAN'>;
     /**
-     * Array of comma separated list of continents (alpha-2 continent codes). Start
-     * with `-` to exclude from results. For example, `-EU,NA` excludes results from
-     * Europe, but includes results from North America.
+     * Filters results by browser family.
+     */
+    browserFamily?: Array<'CHROME' | 'EDGE' | 'FIREFOX' | 'SAFARI'>;
+    /**
+     * Comma-separated list of continents (alpha-2 continent codes). Prefix with `-` to
+     * exclude continents from results. For example, `-EU,NA` excludes results from EU,
+     * but includes results from NA.
      */
     continent?: Array<string>;
     /**
@@ -879,47 +914,47 @@ export interface TimeseriesGroupTLSVersionParams {
      */
     dateEnd?: Array<string>;
     /**
-     * For example, use `7d` and `7dControl` to compare this week with the previous
-     * week. Use this parameter or set specific start and end dates (`dateStart` and
-     * `dateEnd` parameters).
+     * Filters results by the specified date range. For example, use `7d` and
+     * `7dcontrol` to compare this week with the previous week. Use this parameter or
+     * set specific start and end dates (`dateStart` and `dateEnd` parameters).
      */
     dateRange?: Array<string>;
     /**
-     * Array of datetimes to filter the start of a series.
+     * Start of the date range.
      */
     dateStart?: Array<string>;
     /**
-     * Filter for device type.
+     * Filters results by device type.
      */
     deviceType?: Array<'DESKTOP' | 'MOBILE' | 'OTHER'>;
     /**
-     * Format results are returned in.
+     * Format in which results will be returned.
      */
     format?: 'JSON' | 'CSV';
     /**
-     * Filter for http protocol.
+     * Filters results by HTTP protocol (HTTP vs. HTTPS).
      */
     httpProtocol?: Array<'HTTP' | 'HTTPS'>;
     /**
-     * Filter for http version.
+     * Filters results by HTTP version.
      */
     httpVersion?: Array<'HTTPv1' | 'HTTPv2' | 'HTTPv3'>;
     /**
-     * Filter for ip version.
+     * Filters results by IP version (Ipv4 vs. IPv6).
      */
     ipVersion?: Array<'IPv4' | 'IPv6'>;
     /**
-     * Array of comma separated list of locations (alpha-2 country codes). Start with
-     * `-` to exclude from results. For example, `-US,PT` excludes results from the US,
-     * but includes results from PT.
+     * Comma-separated list of locations (alpha-2 codes). Prefix with `-` to exclude
+     * locations from results. For example, `-US,PT` excludes results from the US, but
+     * includes results from PT.
      */
     location?: Array<string>;
     /**
-     * Array of names that will be used to name the series in responses.
+     * Array of names used to label the series in the response.
      */
     name?: Array<string>;
     /**
-     * Filter for os name.
+     * Filters results by operating system.
      */
     os?: Array<'WINDOWS' | 'MACOSX' | 'IOS' | 'ANDROID' | 'CHROMEOS' | 'LINUX' | 'SMART_TV'>;
 }