cloudflare 7.2.0 → 7.3.0

package/src/resources/kv/namespaces/metadata.ts

@@ -13,9 +13,9 @@ export class BaseMetadata extends APIResource {
   ] as const);
 
   /**
-   * Returns the metadata associated with the given key in the given namespace. Use
-   * URL-encoding to use special characters (for example, `:`, `!`, `%`) in the key
-   * name.
+   * Returns the JSON metadata associated with the specified key in the Workers KV
+   * namespace, without retrieving its value. Use URL-encoding for special characters
+   * (for example, `:`, `!`, `%`) in the key name when constructing the request URL.
    *
    * @example
    * ```ts
@@ -47,12 +47,12 @@ export type MetadataGetResponse = unknown;
 
 export interface MetadataGetParams {
   /**
-   * Identifier.
+   * ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
   /**
-   * Namespace identifier tag.
+   * ID of the Workers KV namespace.
    */
   namespace_id: string;
 }

package/src/resources/kv/namespaces/namespaces.ts

@@ -40,9 +40,11 @@ export class BaseNamespaces extends APIResource {
   static override readonly _key: readonly ['kv', 'namespaces'] = Object.freeze(['kv', 'namespaces'] as const);
 
   /**
-   * Creates a namespace under the given title. A `400` is returned if the account
-   * already owns a namespace with this title. A namespace must be explicitly deleted
-   * to be replaced.
+   * Creates a Workers KV namespace in the specified account with the given title.
+   * Returns `400` if the account already owns a namespace with that title; an
+   * existing namespace must be explicitly deleted before it can be replaced. An
+   * optional jurisdiction restricts where data is durably stored and can only be set
+   * at creation time.
    *
    * @example
    * ```ts
@@ -63,7 +65,8 @@ export class BaseNamespaces extends APIResource {
   }
 
   /**
-   * Modifies a namespace's title.
+   * Changes the title of the specified Workers KV namespace and returns the updated
+   * namespace. The namespace ID and stored key-value pairs are unchanged.
    *
    * @example
    * ```ts
@@ -91,7 +94,9 @@ export class BaseNamespaces extends APIResource {
   }
 
   /**
-   * Returns the namespaces owned by an account.
+   * Lists Workers KV namespaces owned by the specified account. Use `page` and
+   * `per_page` to select a page of results, and `order` and `direction` to control
+   * sorting.
    *
    * @example
    * ```ts
@@ -116,7 +121,8 @@ export class BaseNamespaces extends APIResource {
   }
 
   /**
-   * Deletes the namespace corresponding to the given ID.
+   * Deletes the specified Workers KV namespace and its stored key-value pairs from
+   * the account.
    *
    * @example
    * ```ts
@@ -141,8 +147,9 @@ export class BaseNamespaces extends APIResource {
   }
 
   /**
-   * Remove multiple KV pairs from the namespace. Body should be an array of up to
-   * 10,000 keys to be removed.
+   * Deletes up to 10,000 key-value pairs from the specified Workers KV namespace.
+   * Send a JSON array of the key names to delete. The result reports the number of
+   * successful deletions and any keys that failed and should be retried.
    *
    * @example
    * ```ts
@@ -170,9 +177,11 @@ export class BaseNamespaces extends APIResource {
   }
 
   /**
-   * Retrieve up to 100 KV pairs from the namespace. Keys must contain text-based
-   * values. JSON values can optionally be parsed instead of being returned as a
-   * string value. Metadata can be included if `withMetadata` is true.
+   * Retrieves the text-based values of up to 100 keys from the specified Workers KV
+   * namespace. The result maps each requested key to its value. Set `type` to `json`
+   * to parse JSON values instead of returning strings, and set `withMetadata` to
+   * `true` to include metadata with each value. Binary values are not supported by
+   * this operation.
    *
    * @example
    * ```ts
@@ -200,12 +209,13 @@ export class BaseNamespaces extends APIResource {
   }
 
   /**
-   * Write multiple keys and values at once. Body should be an array of up to 10,000
-   * key-value pairs to be stored, along with optional expiration information.
-   * Existing values and expirations will be overwritten. If neither `expiration` nor
-   * `expiration_ttl` is specified, the key-value pair will never expire. If both are
-   * set, `expiration_ttl` is used and `expiration` is ignored. The entire request
-   * size must be 100 megabytes or less.
+   * Writes up to 10,000 key-value pairs to the specified Workers KV namespace from a
+   * JSON array, with optional metadata and expiration settings for each pair.
+   * Existing values and expirations are overwritten. If neither `expiration` nor
+   * `expiration_ttl` is specified, the key-value pair will not expire. If both are
+   * set, `expiration_ttl` takes precedence. The entire request must be 100 megabytes
+   * or less. The result reports the number of successful writes and any keys that
+   * failed and should be retried.
    *
    * @example
    * ```ts
@@ -233,7 +243,7 @@ export class BaseNamespaces extends APIResource {
   }
 
   /**
-   * Get the namespace corresponding to the given ID.
+   * Returns the Workers KV namespace for the specified account and namespace ID.
    *
    * @example
    * ```ts
@@ -263,12 +273,12 @@ export type NamespacesV4PagePaginationArray = V4PagePaginationArray<Namespace>;
 
 export interface Namespace {
   /**
-   * Namespace identifier tag.
+   * ID of the Workers KV namespace.
    */
   id: string;
 
   /**
-   * A human-readable string name for a Namespace.
+   * Human-readable string name for a Workers KV namespace.
    */
   title: string;
 
@@ -289,12 +299,13 @@ export interface NamespaceDeleteResponse {}
 
 export interface NamespaceBulkDeleteResponse {
   /**
-   * Number of keys successfully updated.
+   * Number of keys successfully written or deleted by the bulk operation.
    */
   successful_key_count?: number;
 
   /**
-   * Name of the keys that failed to be fully updated. They should be retried.
+   * Names of keys that failed to be written or deleted. Retry the operation for
+   * these keys.
    */
   unsuccessful_keys?: Array<string>;
 }
@@ -341,24 +352,25 @@ export namespace NamespaceBulkGetResponse {
 
 export interface NamespaceBulkUpdateResponse {
   /**
-   * Number of keys successfully updated.
+   * Number of keys successfully written or deleted by the bulk operation.
    */
   successful_key_count?: number;
 
   /**
-   * Name of the keys that failed to be fully updated. They should be retried.
+   * Names of keys that failed to be written or deleted. Retry the operation for
+   * these keys.
    */
   unsuccessful_keys?: Array<string>;
 }
 
 export interface NamespaceCreateParams {
   /**
-   * Path param: Identifier.
+   * Path param: ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
   /**
-   * Body param: A human-readable string name for a Namespace.
+   * Body param: Human-readable string name for a Workers KV namespace.
    */
   title: string;
 
@@ -371,43 +383,43 @@ export interface NamespaceCreateParams {
 
 export interface NamespaceUpdateParams {
   /**
-   * Path param: Identifier.
+   * Path param: ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
   /**
-   * Body param: A human-readable string name for a Namespace.
+   * Body param: Human-readable string name for a Workers KV namespace.
    */
   title: string;
 }
 
 export interface NamespaceListParams extends V4PagePaginationArrayParams {
   /**
-   * Path param: Identifier.
+   * Path param: ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
   /**
-   * Query param: Direction to order namespaces.
+   * Query param: Sort namespaces in ascending (`asc`) or descending (`desc`) order.
    */
   direction?: 'asc' | 'desc';
 
   /**
-   * Query param: Field to order results by.
+   * Query param: Namespace field to sort by (`id` or `title`).
    */
   order?: 'id' | 'title';
 }
 
 export interface NamespaceDeleteParams {
   /**
-   * Identifier.
+   * ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 }
 
 export interface NamespaceBulkDeleteParams {
   /**
-   * Path param: Identifier.
+   * Path param: ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
@@ -419,7 +431,7 @@ export interface NamespaceBulkDeleteParams {
 
 export interface NamespaceBulkGetParams {
   /**
-   * Path param: Identifier.
+   * Path param: ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
@@ -429,7 +441,8 @@ export interface NamespaceBulkGetParams {
   keys: Array<string>;
 
   /**
-   * Body param: Whether to parse JSON values in the response.
+   * Body param: Return values as strings with `text`, or parse stored JSON values
+   * with `json`.
    */
   type?: 'text' | 'json';
 
@@ -441,7 +454,7 @@ export interface NamespaceBulkGetParams {
 
 export interface NamespaceBulkUpdateParams {
   /**
-   * Path param: Identifier.
+   * Path param: ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
@@ -478,7 +491,8 @@ export namespace NamespaceBulkUpdateParams {
     expiration?: number;
 
     /**
-     * Expires the key after a number of seconds. Must be at least 60.
+     * Number of seconds until the key expires. Must be at least 60. Takes precedence
+     * over `expiration` when both are specified.
      */
     expiration_ttl?: number;
 
@@ -491,7 +505,7 @@ export namespace NamespaceBulkUpdateParams {
 
 export interface NamespaceGetParams {
   /**
-   * Identifier.
+   * ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 }

package/src/resources/kv/namespaces/values.ts

@@ -16,14 +16,14 @@ export class BaseValues extends APIResource {
   ] as const);
 
   /**
-   * Write a value identified by a key. Use URL-encoding to use special characters
-   * (for example, `:`, `!`, `%`) in the key name. Body should be the value to be
-   * stored. If JSON metadata to be associated with the key/value pair is needed, use
-   * `multipart/form-data` content type for your PUT request (see dropdown below in
-   * `REQUEST BODY SCHEMA`). Existing values, expirations, and metadata will be
-   * overwritten. If neither `expiration` nor `expiration_ttl` is specified, the
-   * key-value pair will never expire. If both are set, `expiration_ttl` is used and
-   * `expiration` is ignored.
+   * Writes a value under the specified key in the Workers KV namespace, creating the
+   * key-value pair or replacing its existing value, expiration, and metadata. Send
+   * the value as an `application/octet-stream` request body, or use
+   * `multipart/form-data` with a `value` part and an optional JSON `metadata` part.
+   * Use URL-encoding for special characters (for example, `:`, `!`, `%`) in the key
+   * name when constructing the request URL. If neither `expiration` nor
+   * `expiration_ttl` is specified, the key-value pair will not expire. If both are
+   * set, `expiration_ttl` takes precedence.
    *
    * @example
    * ```ts
@@ -55,8 +55,9 @@ export class BaseValues extends APIResource {
   }
 
   /**
-   * Remove a KV pair from the namespace. Use URL-encoding to use special characters
-   * (for example, `:`, `!`, `%`) in the key name.
+   * Deletes the specified key and its value from the Workers KV namespace. Use
+   * URL-encoding for special characters (for example, `:`, `!`, `%`) in the key name
+   * when constructing the request URL.
    *
    * @example
    * ```ts
@@ -84,11 +85,11 @@ export class BaseValues extends APIResource {
   }
 
   /**
-   * Returns the value associated with the given key in the given namespace. Use
-   * URL-encoding to use special characters (for example, `:`, `!`, `%`) in the key
-   * name. If the KV-pair is set to expire at some point, the expiration time as
-   * measured in seconds since the UNIX epoch will be returned in the `expiration`
-   * response header.
+   * Returns the value stored under the specified key in the Workers KV namespace as
+   * raw bytes. Use URL-encoding for special characters (for example, `:`, `!`, `%`)
+   * in the key name when constructing the request URL. If the key-value pair
+   * expires, the `expiration` response header contains its expiration time in
+   * seconds since the UNIX epoch.
    *
    * @example
    * ```ts
@@ -124,12 +125,12 @@ export interface ValueDeleteResponse {}
 
 export interface ValueUpdateParams {
   /**
-   * Path param: Identifier.
+   * Path param: ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
   /**
-   * Path param: Namespace identifier tag.
+   * Path param: ID of the Workers KV namespace.
    */
   namespace_id: string;
 
@@ -145,7 +146,8 @@ export interface ValueUpdateParams {
   expiration?: number;
 
   /**
-   * Query param: Expires the key after a number of seconds. Must be at least 60.
+   * Query param: Number of seconds until the key expires. Must be at least 60. Takes
+   * precedence over `expiration` when both are specified.
    */
   expiration_ttl?: number;
 
@@ -157,24 +159,24 @@ export interface ValueUpdateParams {
 
 export interface ValueDeleteParams {
   /**
-   * Identifier.
+   * ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
   /**
-   * Namespace identifier tag.
+   * ID of the Workers KV namespace.
    */
   namespace_id: string;
 }
 
 export interface ValueGetParams {
   /**
-   * Identifier.
+   * ID of the Cloudflare account that owns the Workers KV namespaces.
    */
   account_id: string;
 
   /**
-   * Namespace identifier tag.
+   * ID of the Workers KV namespace.
    */
   namespace_id: string;
 }

package/src/resources/logpush/jobs.ts

@@ -396,7 +396,8 @@ export interface OutputOptions {
 
   /**
    * If set to true, subrequests will be merged into the parent request. Only
-   * supported for the `http_requests` dataset.
+   * supported for the `http_requests` dataset. Not supported for account-scoped
+   * jobs.
    */
   merge_subrequests?: boolean | null;
 
@@ -479,7 +480,8 @@ export interface OutputOptionsParam {
 
   /**
    * If set to true, subrequests will be merged into the parent request. Only
-   * supported for the `http_requests` dataset.
+   * supported for the `http_requests` dataset. Not supported for account-scoped
+   * jobs.
    */
   merge_subrequests?: boolean | null;
 

package/src/resources/logs/log-explorer/datasets/datasets.ts

@@ -257,12 +257,18 @@ export interface CreateRequest {
   fields?: Array<CreateRequest.Field>;
 
   /**
-   * Optional Logpush filter predicate to restrict which events are ingested. If
-   * provided, replaces the dataset's default filter entirely. See
+   * Optional Logpush filter predicate to restrict which events are ingested. See
    * [Logpush filters](https://developers.cloudflare.com/logs/reference/filters/) for
    * syntax and examples.
    */
   filter?: string;
+
+  /**
+   * Whether to filter attack traffic from the Logpush job. Defaults to `true` for
+   * supported datasets when omitted. Supported datasets are `http_requests`,
+   * `firewall_events`, and `network_analytics_logs`.
+   */
+  filter_attack_traffic?: boolean;
 }
 
 export namespace CreateRequest {
@@ -334,6 +340,12 @@ export interface Dataset {
    * set.
    */
   filter?: string;
+
+  /**
+   * Whether the Logpush job filters attack traffic. Omitted for datasets that do not
+   * support this option.
+   */
+  filter_attack_traffic?: boolean;
 }
 
 export namespace Dataset {
@@ -421,6 +433,13 @@ export interface UpdateRequest {
    * syntax and examples.
    */
   filter?: string | null;
+
+  /**
+   * Whether to filter attack traffic from the Logpush job. If omitted, the existing
+   * setting is left unchanged. Supported datasets are `http_requests`,
+   * `firewall_events`, and `network_analytics_logs`.
+   */
+  filter_attack_traffic?: boolean;
 }
 
 export namespace UpdateRequest {
@@ -463,11 +482,18 @@ export interface DatasetCreateParams {
 
   /**
    * Body param: Optional Logpush filter predicate to restrict which events are
-   * ingested. If provided, replaces the dataset's default filter entirely. See
+   * ingested. See
    * [Logpush filters](https://developers.cloudflare.com/logs/reference/filters/) for
    * syntax and examples.
    */
   filter?: string;
+
+  /**
+   * Body param: Whether to filter attack traffic from the Logpush job. Defaults to
+   * `true` for supported datasets when omitted. Supported datasets are
+   * `http_requests`, `firewall_events`, and `network_analytics_logs`.
+   */
+  filter_attack_traffic?: boolean;
 }
 
 export namespace DatasetCreateParams {
@@ -522,6 +548,13 @@ export interface DatasetUpdateParams {
    * syntax and examples.
    */
   filter?: string | null;
+
+  /**
+   * Body param: Whether to filter attack traffic from the Logpush job. If omitted,
+   * the existing setting is left unchanged. Supported datasets are `http_requests`,
+   * `firewall_events`, and `network_analytics_logs`.
+   */
+  filter_attack_traffic?: boolean;
 }
 
 export namespace DatasetUpdateParams {

package/src/resources/magic-transit/sites/lans.ts

@@ -515,6 +515,12 @@ export interface LANUpdateParams {
    */
   bond_id?: number;
 
+  /**
+   * Body param: mark true to use this LAN for HA probing. only works for site with
+   * HA turned on. only one LAN can be set as the ha_link.
+   */
+  ha_link?: boolean;
+
   /**
    * Body param: mark true to use this LAN for source-based breakout traffic
    */
@@ -594,6 +600,12 @@ export interface LANEditParams {
    */
   bond_id?: number;
 
+  /**
+   * Body param: mark true to use this LAN for HA probing. only works for site with
+   * HA turned on. only one LAN can be set as the ha_link.
+   */
+  ha_link?: boolean;
+
   /**
    * Body param: mark true to use this LAN for source-based breakout traffic
    */

package/src/resources/magic-transit/sites/sites.ts

@@ -322,6 +322,12 @@ export interface SiteUpdateParams {
    */
   description?: string;
 
+  /**
+   * Body param: Site high availability mode. If set to true, the site can have two
+   * connectors and runs in high availability mode.
+   */
+  ha_mode?: boolean;
+
   /**
    * Body param: Location of site in latitude and longitude.
    */
@@ -374,6 +380,12 @@ export interface SiteEditParams {
    */
   description?: string;
 
+  /**
+   * Body param: Site high availability mode. If set to true, the site can have two
+   * connectors and runs in high availability mode.
+   */
+  ha_mode?: boolean;
+
   /**
    * Body param: Location of site in latitude and longitude.
    */

package/src/resources/magic-transit/sites/wans.ts

@@ -178,6 +178,8 @@ export interface WAN {
    */
   health_check_rate?: 'low' | 'mid' | 'high';
 
+  load_balance_inner_flows?: boolean;
+
   name?: string;
 
   physport?: number;
@@ -257,6 +259,17 @@ export interface WANCreateParams {
    */
   physport: number;
 
+  /**
+   * Body param: Magic WAN health check rate for tunnels created on this link. The
+   * default value is `mid`.
+   */
+  health_check_rate?: 'low' | 'mid' | 'high';
+
+  /**
+   * Body param
+   */
+  load_balance_inner_flows?: boolean;
+
   /**
    * Body param
    */
@@ -290,6 +303,16 @@ export interface WANUpdateParams {
    */
   site_id: string;
 
+  /**
+   * Body param: Magic WAN health check rate for tunnels created on this link.
+   */
+  health_check_rate?: 'low' | 'mid' | 'high';
+
+  /**
+   * Body param
+   */
+  load_balance_inner_flows?: boolean | null;
+
   /**
    * Body param
    */
@@ -347,6 +370,16 @@ export interface WANEditParams {
    */
   site_id: string;
 
+  /**
+   * Body param: Magic WAN health check rate for tunnels created on this link.
+   */
+  health_check_rate?: 'low' | 'mid' | 'high';
+
+  /**
+   * Body param
+   */
+  load_balance_inner_flows?: boolean | null;
+
   /**
    * Body param
    */