cloudflare 7.0.0 → 7.1.0

package/src/resources/email-security/settings/block-senders.ts

@@ -156,11 +156,11 @@ export class BlockSenders extends BaseBlockSenders {}
 export type BlockSenderListResponsesV4PagePaginationArray = V4PagePaginationArray<BlockSenderListResponse>;
 
 /**
- * A blocked sender pattern
+ * A blocked sender pattern.
  */
 export interface BlockSenderCreateResponse {
   /**
-   * Blocked sender pattern identifier
+   * Blocked sender pattern identifier.
    */
   id?: string;
 
@@ -171,28 +171,40 @@ export interface BlockSenderCreateResponse {
   is_regex?: boolean;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
   modified_at?: string;
 
+  /**
+   * The pattern value to match. The format depends on `pattern_type`: a valid email
+   * address for EMAIL (e.g. `user@example.com`), a valid domain name for DOMAIN
+   * (e.g. `example.com`), or a plain IPv4 address or IPv4 CIDR block for IP (e.g.
+   * `1.2.3.4` or `1.2.3.0/24`); the API accepts only globally reachable IP addresses
+   * and rejects private, loopback, link-local, and unspecified addresses.
+   */
   pattern?: string;
 
   /**
-   * Type of pattern matching. Note: UNKNOWN is deprecated and cannot be used when
-   * creating or updating policies, but may be returned for existing entries.
+   * Type of pattern matching.
+   *
+   * - EMAIL: matches a full email address (e.g. `user@example.com`)
+   * - DOMAIN: matches a domain name (e.g. `example.com`)
+   * - IP: matches a plain IPv4 address (e.g. `1.2.3.4`) or an IPv4 CIDR block (e.g.
+   *   `1.2.3.0/24`). The API accepts only globally reachable addresses.
+   * - UNKNOWN: deprecated; you cannot use this when creating or updating policies,
+   *   but it may appear on existing entries.
    */
   pattern_type?: 'EMAIL' | 'DOMAIN' | 'IP' | 'UNKNOWN';
 }
 
 /**
- * A blocked sender pattern
+ * A blocked sender pattern.
  */
 export interface BlockSenderListResponse {
   /**
-   * Blocked sender pattern identifier
+   * Blocked sender pattern identifier.
    */
   id?: string;
 
@@ -203,35 +215,47 @@ export interface BlockSenderListResponse {
   is_regex?: boolean;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
   modified_at?: string;
 
+  /**
+   * The pattern value to match. The format depends on `pattern_type`: a valid email
+   * address for EMAIL (e.g. `user@example.com`), a valid domain name for DOMAIN
+   * (e.g. `example.com`), or a plain IPv4 address or IPv4 CIDR block for IP (e.g.
+   * `1.2.3.4` or `1.2.3.0/24`); the API accepts only globally reachable IP addresses
+   * and rejects private, loopback, link-local, and unspecified addresses.
+   */
   pattern?: string;
 
   /**
-   * Type of pattern matching. Note: UNKNOWN is deprecated and cannot be used when
-   * creating or updating policies, but may be returned for existing entries.
+   * Type of pattern matching.
+   *
+   * - EMAIL: matches a full email address (e.g. `user@example.com`)
+   * - DOMAIN: matches a domain name (e.g. `example.com`)
+   * - IP: matches a plain IPv4 address (e.g. `1.2.3.4`) or an IPv4 CIDR block (e.g.
+   *   `1.2.3.0/24`). The API accepts only globally reachable addresses.
+   * - UNKNOWN: deprecated; you cannot use this when creating or updating policies,
+   *   but it may appear on existing entries.
    */
   pattern_type?: 'EMAIL' | 'DOMAIN' | 'IP' | 'UNKNOWN';
 }
 
 export interface BlockSenderDeleteResponse {
   /**
-   * Blocked sender pattern identifier
+   * Blocked sender pattern identifier.
    */
   id: string;
 }
 
 /**
- * A blocked sender pattern
+ * A blocked sender pattern.
  */
 export interface BlockSenderEditResponse {
   /**
-   * Blocked sender pattern identifier
+   * Blocked sender pattern identifier.
    */
   id?: string;
 
@@ -242,28 +266,40 @@ export interface BlockSenderEditResponse {
   is_regex?: boolean;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
   modified_at?: string;
 
+  /**
+   * The pattern value to match. The format depends on `pattern_type`: a valid email
+   * address for EMAIL (e.g. `user@example.com`), a valid domain name for DOMAIN
+   * (e.g. `example.com`), or a plain IPv4 address or IPv4 CIDR block for IP (e.g.
+   * `1.2.3.4` or `1.2.3.0/24`); the API accepts only globally reachable IP addresses
+   * and rejects private, loopback, link-local, and unspecified addresses.
+   */
   pattern?: string;
 
   /**
-   * Type of pattern matching. Note: UNKNOWN is deprecated and cannot be used when
-   * creating or updating policies, but may be returned for existing entries.
+   * Type of pattern matching.
+   *
+   * - EMAIL: matches a full email address (e.g. `user@example.com`)
+   * - DOMAIN: matches a domain name (e.g. `example.com`)
+   * - IP: matches a plain IPv4 address (e.g. `1.2.3.4`) or an IPv4 CIDR block (e.g.
+   *   `1.2.3.0/24`). The API accepts only globally reachable addresses.
+   * - UNKNOWN: deprecated; you cannot use this when creating or updating policies,
+   *   but it may appear on existing entries.
    */
   pattern_type?: 'EMAIL' | 'DOMAIN' | 'IP' | 'UNKNOWN';
 }
 
 /**
- * A blocked sender pattern
+ * A blocked sender pattern.
  */
 export interface BlockSenderGetResponse {
   /**
-   * Blocked sender pattern identifier
+   * Blocked sender pattern identifier.
    */
   id?: string;
 
@@ -274,18 +310,30 @@ export interface BlockSenderGetResponse {
   is_regex?: boolean;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
   modified_at?: string;
 
+  /**
+   * The pattern value to match. The format depends on `pattern_type`: a valid email
+   * address for EMAIL (e.g. `user@example.com`), a valid domain name for DOMAIN
+   * (e.g. `example.com`), or a plain IPv4 address or IPv4 CIDR block for IP (e.g.
+   * `1.2.3.4` or `1.2.3.0/24`); the API accepts only globally reachable IP addresses
+   * and rejects private, loopback, link-local, and unspecified addresses.
+   */
   pattern?: string;
 
   /**
-   * Type of pattern matching. Note: UNKNOWN is deprecated and cannot be used when
-   * creating or updating policies, but may be returned for existing entries.
+   * Type of pattern matching.
+   *
+   * - EMAIL: matches a full email address (e.g. `user@example.com`)
+   * - DOMAIN: matches a domain name (e.g. `example.com`)
+   * - IP: matches a plain IPv4 address (e.g. `1.2.3.4`) or an IPv4 CIDR block (e.g.
+   *   `1.2.3.0/24`). The API accepts only globally reachable addresses.
+   * - UNKNOWN: deprecated; you cannot use this when creating or updating policies,
+   *   but it may appear on existing entries.
    */
   pattern_type?: 'EMAIL' | 'DOMAIN' | 'IP' | 'UNKNOWN';
 }
@@ -302,14 +350,23 @@ export interface BlockSenderCreateParams {
   is_regex: boolean;
 
   /**
-   * Body param
+   * Body param: The pattern value to match. The format depends on `pattern_type`: a
+   * valid email address for EMAIL (e.g. `user@example.com`), a valid domain name for
+   * DOMAIN (e.g. `example.com`), or a plain IPv4 address or IPv4 CIDR block for IP
+   * (e.g. `1.2.3.4` or `1.2.3.0/24`); the API accepts only globally reachable IP
+   * addresses and rejects private, loopback, link-local, and unspecified addresses.
    */
   pattern: string;
 
   /**
-   * Body param: Type of pattern matching. Note: UNKNOWN is deprecated and cannot be
-   * used when creating or updating policies, but may be returned for existing
-   * entries.
+   * Body param: Type of pattern matching.
+   *
+   * - EMAIL: matches a full email address (e.g. `user@example.com`)
+   * - DOMAIN: matches a domain name (e.g. `example.com`)
+   * - IP: matches a plain IPv4 address (e.g. `1.2.3.4`) or an IPv4 CIDR block (e.g.
+   *   `1.2.3.0/24`). The API accepts only globally reachable addresses.
+   * - UNKNOWN: deprecated; you cannot use this when creating or updating policies,
+   *   but it may appear on existing entries.
    */
   pattern_type: 'EMAIL' | 'DOMAIN' | 'IP' | 'UNKNOWN';
 
@@ -375,14 +432,23 @@ export interface BlockSenderEditParams {
   is_regex?: boolean;
 
   /**
-   * Body param
+   * Body param: The pattern value to match. The format depends on `pattern_type`: a
+   * valid email address for EMAIL (e.g. `user@example.com`), a valid domain name for
+   * DOMAIN (e.g. `example.com`), or a plain IPv4 address or IPv4 CIDR block for IP
+   * (e.g. `1.2.3.4` or `1.2.3.0/24`); the API accepts only globally reachable IP
+   * addresses and rejects private, loopback, link-local, and unspecified addresses.
    */
   pattern?: string;
 
   /**
-   * Body param: Type of pattern matching. Note: UNKNOWN is deprecated and cannot be
-   * used when creating or updating policies, but may be returned for existing
-   * entries.
+   * Body param: Type of pattern matching.
+   *
+   * - EMAIL: matches a full email address (e.g. `user@example.com`)
+   * - DOMAIN: matches a domain name (e.g. `example.com`)
+   * - IP: matches a plain IPv4 address (e.g. `1.2.3.4`) or an IPv4 CIDR block (e.g.
+   *   `1.2.3.0/24`). The API accepts only globally reachable addresses.
+   * - UNKNOWN: deprecated; you cannot use this when creating or updating policies,
+   *   but it may appear on existing entries.
    */
   pattern_type?: 'EMAIL' | 'DOMAIN' | 'IP' | 'UNKNOWN';
 }

package/src/resources/email-security/settings/domains.ts

@@ -4,6 +4,7 @@ import { APIResource } from '../../../core/resource';
 import { APIPromise } from '../../../core/api-promise';
 import {
   PagePromise,
+  SinglePage,
   V4PagePaginationArray,
   type V4PagePaginationArrayParams,
 } from '../../../core/pagination';
@@ -72,6 +73,24 @@ export class BaseDomains extends APIResource {
     )._thenUnwrap((obj) => obj.result);
   }
 
+  /**
+   * Removes protection from multiple email domains. Deprecated; use the batch
+   * endpoint instead.
+   *
+   * @deprecated
+   */
+  bulkDelete(
+    params: DomainBulkDeleteParams,
+    options?: RequestOptions,
+  ): PagePromise<DomainBulkDeleteResponsesSinglePage, DomainBulkDeleteResponse> {
+    const { account_id } = params;
+    return this._client.getAPIList(
+      path`/accounts/${account_id}/email-security/settings/domains`,
+      SinglePage<DomainBulkDeleteResponse>,
+      { method: 'delete', ...options },
+    );
+  }
+
   /**
    * Updates configuration for a protected email domain. Only provided fields will be
    * modified. Changes affect delivery mode, security settings, and regional
@@ -123,9 +142,11 @@ export class Domains extends BaseDomains {}
 
 export type DomainListResponsesV4PagePaginationArray = V4PagePaginationArray<DomainListResponse>;
 
+export type DomainBulkDeleteResponsesSinglePage = SinglePage<DomainBulkDeleteResponse>;
+
 export interface DomainListResponse {
   /**
-   * Domain identifier
+   * Domain identifier.
    */
   id?: string;
 
@@ -135,7 +156,7 @@ export interface DomainListResponse {
 
   created_at?: string;
 
-  dmarc_status?: 'none' | 'good' | 'invalid';
+  dmarc_status?: 'none' | 'good' | 'invalid' | null;
 
   domain?: string;
 
@@ -154,7 +175,7 @@ export interface DomainListResponse {
 
   emails_processed?: DomainListResponse.EmailsProcessed;
 
-  folder?: 'AllItems' | 'Inbox';
+  folder?: 'AllItems' | 'Inbox' | null;
 
   inbox_provider?: 'Microsoft' | 'Google' | null;
 
@@ -163,8 +184,7 @@ export interface DomainListResponse {
   ip_restrictions?: Array<string>;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
@@ -180,9 +200,9 @@ export interface DomainListResponse {
 
   require_tls_outbound?: boolean | null;
 
-  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid';
+  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid' | null;
 
-  status?: 'pending' | 'active' | 'failed' | 'timeout';
+  status?: 'pending' | 'active' | 'failed' | 'timeout' | null;
 
   transport?: string;
 }
@@ -207,14 +227,21 @@ export namespace DomainListResponse {
 
 export interface DomainDeleteResponse {
   /**
-   * Domain identifier
+   * Domain identifier.
+   */
+  id: string;
+}
+
+export interface DomainBulkDeleteResponse {
+  /**
+   * Domain identifier.
    */
   id: string;
 }
 
 export interface DomainEditResponse {
   /**
-   * Domain identifier
+   * Domain identifier.
    */
   id?: string;
 
@@ -224,7 +251,7 @@ export interface DomainEditResponse {
 
   created_at?: string;
 
-  dmarc_status?: 'none' | 'good' | 'invalid';
+  dmarc_status?: 'none' | 'good' | 'invalid' | null;
 
   domain?: string;
 
@@ -243,7 +270,7 @@ export interface DomainEditResponse {
 
   emails_processed?: DomainEditResponse.EmailsProcessed;
 
-  folder?: 'AllItems' | 'Inbox';
+  folder?: 'AllItems' | 'Inbox' | null;
 
   inbox_provider?: 'Microsoft' | 'Google' | null;
 
@@ -252,8 +279,7 @@ export interface DomainEditResponse {
   ip_restrictions?: Array<string>;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
@@ -269,9 +295,9 @@ export interface DomainEditResponse {
 
   require_tls_outbound?: boolean | null;
 
-  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid';
+  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid' | null;
 
-  status?: 'pending' | 'active' | 'failed' | 'timeout';
+  status?: 'pending' | 'active' | 'failed' | 'timeout' | null;
 
   transport?: string;
 }
@@ -296,7 +322,7 @@ export namespace DomainEditResponse {
 
 export interface DomainGetResponse {
   /**
-   * Domain identifier
+   * Domain identifier.
    */
   id?: string;
 
@@ -306,7 +332,7 @@ export interface DomainGetResponse {
 
   created_at?: string;
 
-  dmarc_status?: 'none' | 'good' | 'invalid';
+  dmarc_status?: 'none' | 'good' | 'invalid' | null;
 
   domain?: string;
 
@@ -325,7 +351,7 @@ export interface DomainGetResponse {
 
   emails_processed?: DomainGetResponse.EmailsProcessed;
 
-  folder?: 'AllItems' | 'Inbox';
+  folder?: 'AllItems' | 'Inbox' | null;
 
   inbox_provider?: 'Microsoft' | 'Google' | null;
 
@@ -334,8 +360,7 @@ export interface DomainGetResponse {
   ip_restrictions?: Array<string>;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
@@ -351,9 +376,9 @@ export interface DomainGetResponse {
 
   require_tls_outbound?: boolean | null;
 
-  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid';
+  spf_status?: 'none' | 'good' | 'neutral' | 'open' | 'invalid' | null;
 
-  status?: 'pending' | 'active' | 'failed' | 'timeout';
+  status?: 'pending' | 'active' | 'failed' | 'timeout' | null;
 
   transport?: string;
 }
@@ -420,7 +445,7 @@ export interface DomainListParams extends V4PagePaginationArrayParams {
   /**
    * Query param: Filters response to domains with the provided status.
    */
-  status?: 'pending' | 'active' | 'failed' | 'timeout';
+  status?: 'pending' | 'active' | 'failed' | 'timeout' | null;
 }
 
 export interface DomainDeleteParams {
@@ -430,21 +455,23 @@ export interface DomainDeleteParams {
   account_id: string;
 }
 
-export interface DomainEditParams {
+export interface DomainBulkDeleteParams {
   /**
-   * Path param: Identifier.
+   * Identifier.
    */
   account_id: string;
+}
 
+export interface DomainEditParams {
   /**
-   * Body param
+   * Path param: Identifier.
    */
-  allowed_delivery_modes?: Array<'DIRECT' | 'BCC' | 'JOURNAL' | 'API' | 'RETRO_SCAN'>;
+  account_id: string;
 
   /**
    * Body param
    */
-  domain?: string;
+  allowed_delivery_modes?: Array<'DIRECT' | 'BCC' | 'JOURNAL' | 'API' | 'RETRO_SCAN'>;
 
   /**
    * Body param
@@ -465,7 +492,7 @@ export interface DomainEditParams {
   /**
    * Body param
    */
-  folder?: 'AllItems' | 'Inbox';
+  folder?: 'AllItems' | 'Inbox' | null;
 
   /**
    * Body param
@@ -514,11 +541,14 @@ export declare namespace Domains {
   export {
     type DomainListResponse as DomainListResponse,
     type DomainDeleteResponse as DomainDeleteResponse,
+    type DomainBulkDeleteResponse as DomainBulkDeleteResponse,
     type DomainEditResponse as DomainEditResponse,
     type DomainGetResponse as DomainGetResponse,
     type DomainListResponsesV4PagePaginationArray as DomainListResponsesV4PagePaginationArray,
+    type DomainBulkDeleteResponsesSinglePage as DomainBulkDeleteResponsesSinglePage,
     type DomainListParams as DomainListParams,
     type DomainDeleteParams as DomainDeleteParams,
+    type DomainBulkDeleteParams as DomainBulkDeleteParams,
     type DomainEditParams as DomainEditParams,
     type DomainGetParams as DomainGetParams,
   };

package/src/resources/email-security/settings/impersonation-registry.ts

@@ -161,11 +161,11 @@ export type ImpersonationRegistryListResponsesV4PagePaginationArray =
   V4PagePaginationArray<ImpersonationRegistryListResponse>;
 
 /**
- * An impersonation registry entry
+ * An impersonation registry entry.
  */
 export interface ImpersonationRegistryCreateResponse {
   /**
-   * Impersonation registry entry identifier
+   * Impersonation registry entry identifier.
    */
   id?: string;
 
@@ -180,15 +180,14 @@ export interface ImpersonationRegistryCreateResponse {
   email?: string;
 
   /**
-   * @deprecated
+   * @deprecated This field is deprecated.
    */
   external_directory_node_id?: string | null;
 
   is_email_regex?: boolean;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
@@ -200,11 +199,11 @@ export interface ImpersonationRegistryCreateResponse {
 }
 
 /**
- * An impersonation registry entry
+ * An impersonation registry entry.
  */
 export interface ImpersonationRegistryListResponse {
   /**
-   * Impersonation registry entry identifier
+   * Impersonation registry entry identifier.
    */
   id?: string;
 
@@ -219,15 +218,14 @@ export interface ImpersonationRegistryListResponse {
   email?: string;
 
   /**
-   * @deprecated
+   * @deprecated This field is deprecated.
    */
   external_directory_node_id?: string | null;
 
   is_email_regex?: boolean;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
@@ -240,17 +238,17 @@ export interface ImpersonationRegistryListResponse {
 
 export interface ImpersonationRegistryDeleteResponse {
   /**
-   * Impersonation registry entry identifier
+   * Impersonation registry entry identifier.
    */
   id: string;
 }
 
 /**
- * An impersonation registry entry
+ * An impersonation registry entry.
  */
 export interface ImpersonationRegistryEditResponse {
   /**
-   * Impersonation registry entry identifier
+   * Impersonation registry entry identifier.
    */
   id?: string;
 
@@ -265,15 +263,14 @@ export interface ImpersonationRegistryEditResponse {
   email?: string;
 
   /**
-   * @deprecated
+   * @deprecated This field is deprecated.
    */
   external_directory_node_id?: string | null;
 
   is_email_regex?: boolean;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
@@ -285,11 +282,11 @@ export interface ImpersonationRegistryEditResponse {
 }
 
 /**
- * An impersonation registry entry
+ * An impersonation registry entry.
  */
 export interface ImpersonationRegistryGetResponse {
   /**
-   * Impersonation registry entry identifier
+   * Impersonation registry entry identifier.
    */
   id?: string;
 
@@ -304,15 +301,14 @@ export interface ImpersonationRegistryGetResponse {
   email?: string;
 
   /**
-   * @deprecated
+   * @deprecated This field is deprecated.
    */
   external_directory_node_id?: string | null;
 
   is_email_regex?: boolean;
 
   /**
-   * @deprecated Deprecated, use `modified_at` instead. End of life: November
-   * 1, 2026.
+   * @deprecated Use `modified_at` instead.
    */
   last_modified?: string;
 
@@ -360,7 +356,7 @@ export interface ImpersonationRegistryCreateParams {
   directory_node_id?: number | null;
 
   /**
-   * @deprecated Body param
+   * @deprecated This field is deprecated.
    */
   external_directory_node_id?: string | null;
 
@@ -431,7 +427,7 @@ export interface ImpersonationRegistryEditParams {
   email?: string;
 
   /**
-   * @deprecated Body param
+   * @deprecated This field is deprecated.
    */
   external_directory_node_id?: string | null;
 

package/src/resources/email-security/settings/index.ts

@@ -35,13 +35,16 @@ export {
   BaseDomains,
   type DomainListResponse,
   type DomainDeleteResponse,
+  type DomainBulkDeleteResponse,
   type DomainEditResponse,
   type DomainGetResponse,
   type DomainListParams,
   type DomainDeleteParams,
+  type DomainBulkDeleteParams,
   type DomainEditParams,
   type DomainGetParams,
   type DomainListResponsesV4PagePaginationArray,
+  type DomainBulkDeleteResponsesSinglePage,
 } from './domains';
 export {
   ImpersonationRegistry,