cloudflare 5.2.0 → 6.0.0-beta.2

package/src/resources/dns/records.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
+import { isRequestOptions } from '../../core';
 import * as Core from '../../core';
 import * as RecordsAPI from './records';
 import * as Shared from '../shared';
@@ -28,7 +29,7 @@ export class Records extends APIResource {
    * ```
    */
   create(params: RecordCreateParams, options?: Core.RequestOptions): Core.APIPromise<RecordResponse> {
-    const { zone_id, ...body } = params;
+    const { zone_id = this._client.zoneId, ...body } = params;
     return (
       this._client.post(`/zones/${zone_id}/dns_records`, { body, ...options }) as Core.APIPromise<{
         result: RecordResponse;
@@ -64,7 +65,7 @@ export class Records extends APIResource {
     params: RecordUpdateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<RecordResponse> {
-    const { zone_id, ...body } = params;
+    const { zone_id = this._client.zoneId, ...body } = params;
     return (
       this._client.put(`/zones/${zone_id}/dns_records/${dnsRecordId}`, {
         body,
@@ -87,10 +88,18 @@ export class Records extends APIResource {
    * ```
    */
   list(
-    params: RecordListParams,
+    params?: RecordListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<RecordResponsesV4PagePaginationArray, RecordResponse>;
+  list(options?: Core.RequestOptions): Core.PagePromise<RecordResponsesV4PagePaginationArray, RecordResponse>;
+  list(
+    params: RecordListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.PagePromise<RecordResponsesV4PagePaginationArray, RecordResponse> {
-    const { zone_id, ...query } = params;
+    if (isRequestOptions(params)) {
+      return this.list({}, params);
+    }
+    const { zone_id = this._client.zoneId, ...query } = params;
     return this._client.getAPIList(`/zones/${zone_id}/dns_records`, RecordResponsesV4PagePaginationArray, {
       query,
       ...options,
@@ -110,10 +119,19 @@ export class Records extends APIResource {
    */
   delete(
     dnsRecordId: string,
-    params: RecordDeleteParams,
+    params?: RecordDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<RecordDeleteResponse>;
+  delete(dnsRecordId: string, options?: Core.RequestOptions): Core.APIPromise<RecordDeleteResponse>;
+  delete(
+    dnsRecordId: string,
+    params: RecordDeleteParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<RecordDeleteResponse> {
-    const { zone_id } = params;
+    if (isRequestOptions(params)) {
+      return this.delete(dnsRecordId, {}, params);
+    }
+    const { zone_id = this._client.zoneId } = params;
     return (
       this._client.delete(`/zones/${zone_id}/dns_records/${dnsRecordId}`, options) as Core.APIPromise<{
         result: RecordDeleteResponse;
@@ -147,8 +165,16 @@ export class Records extends APIResource {
    * });
    * ```
    */
-  batch(params: RecordBatchParams, options?: Core.RequestOptions): Core.APIPromise<RecordBatchResponse> {
-    const { zone_id, ...body } = params;
+  batch(params?: RecordBatchParams, options?: Core.RequestOptions): Core.APIPromise<RecordBatchResponse>;
+  batch(options?: Core.RequestOptions): Core.APIPromise<RecordBatchResponse>;
+  batch(
+    params: RecordBatchParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<RecordBatchResponse> {
+    if (isRequestOptions(params)) {
+      return this.batch({}, params);
+    }
+    const { zone_id = this._client.zoneId, ...body } = params;
     return (
       this._client.post(`/zones/${zone_id}/dns_records/batch`, { body, ...options }) as Core.APIPromise<{
         result: RecordBatchResponse;
@@ -184,7 +210,7 @@ export class Records extends APIResource {
     params: RecordEditParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<RecordResponse> {
-    const { zone_id, ...body } = params;
+    const { zone_id = this._client.zoneId, ...body } = params;
     return (
       this._client.patch(`/zones/${zone_id}/dns_records/${dnsRecordId}`, {
         body,
@@ -209,8 +235,16 @@ export class Records extends APIResource {
    * });
    * ```
    */
-  export(params: RecordExportParams, options?: Core.RequestOptions): Core.APIPromise<string> {
-    const { zone_id } = params;
+  export(params?: RecordExportParams, options?: Core.RequestOptions): Core.APIPromise<string>;
+  export(options?: Core.RequestOptions): Core.APIPromise<string>;
+  export(
+    params: RecordExportParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<string> {
+    if (isRequestOptions(params)) {
+      return this.export({}, params);
+    }
+    const { zone_id = this._client.zoneId } = params;
     return this._client.get(`/zones/${zone_id}/dns_records/export`, {
       ...options,
       headers: { Accept: 'text/plain', ...options?.headers },
@@ -230,10 +264,19 @@ export class Records extends APIResource {
    */
   get(
     dnsRecordId: string,
-    params: RecordGetParams,
+    params?: RecordGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<RecordResponse>;
+  get(dnsRecordId: string, options?: Core.RequestOptions): Core.APIPromise<RecordResponse>;
+  get(
+    dnsRecordId: string,
+    params: RecordGetParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<RecordResponse> {
-    const { zone_id } = params;
+    if (isRequestOptions(params)) {
+      return this.get(dnsRecordId, {}, params);
+    }
+    const { zone_id = this._client.zoneId } = params;
     return (
       this._client.get(`/zones/${zone_id}/dns_records/${dnsRecordId}`, options) as Core.APIPromise<{
         result: RecordResponse;
@@ -260,7 +303,7 @@ export class Records extends APIResource {
    * ```
    */
   import(params: RecordImportParams, options?: Core.RequestOptions): Core.APIPromise<RecordImportResponse> {
-    const { zone_id, ...body } = params;
+    const { zone_id = this._client.zoneId, ...body } = params;
     return (
       this._client.post(
         `/zones/${zone_id}/dns_records/import`,
@@ -276,7 +319,7 @@ export class Records extends APIResource {
    * @deprecated This endpoint is deprecated in favor of a new asynchronous version. Please use the [/scan/trigger](https://developers.cloudflare.com/api/resources/dns/subresources/records/methods/scan/trigger) and [/scan/review](https://developers.cloudflare.com/api/resources/dns/subresources/records/methods/scan/review) endpoints instead.
    */
   scan(params: RecordScanParams, options?: Core.RequestOptions): Core.APIPromise<RecordScanResponse> {
-    const { zone_id, body } = params;
+    const { zone_id = this._client.zoneId, body } = params;
     return (
       this._client.post(`/zones/${zone_id}/dns_records/scan`, { body: body, ...options }) as Core.APIPromise<{
         result: RecordScanResponse;
@@ -301,10 +344,18 @@ export class Records extends APIResource {
    * ```
    */
   scanList(
-    params: RecordScanListParams,
+    params?: RecordScanListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<RecordResponsesSinglePage, RecordResponse>;
+  scanList(options?: Core.RequestOptions): Core.PagePromise<RecordResponsesSinglePage, RecordResponse>;
+  scanList(
+    params: RecordScanListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.PagePromise<RecordResponsesSinglePage, RecordResponse> {
-    const { zone_id } = params;
+    if (isRequestOptions(params)) {
+      return this.scanList({}, params);
+    }
+    const { zone_id = this._client.zoneId } = params;
     return this._client.getAPIList(
       `/zones/${zone_id}/dns_records/scan/review`,
       RecordResponsesSinglePage,
@@ -325,10 +376,18 @@ export class Records extends APIResource {
    * ```
    */
   scanReview(
-    params: RecordScanReviewParams,
+    params?: RecordScanReviewParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<RecordScanReviewResponse>;
+  scanReview(options?: Core.RequestOptions): Core.APIPromise<RecordScanReviewResponse>;
+  scanReview(
+    params: RecordScanReviewParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<RecordScanReviewResponse> {
-    const { zone_id, ...body } = params;
+    if (isRequestOptions(params)) {
+      return this.scanReview({}, params);
+    }
+    const { zone_id = this._client.zoneId, ...body } = params;
     return (
       this._client.post(`/zones/${zone_id}/dns_records/scan/review`, {
         body,
@@ -351,10 +410,18 @@ export class Records extends APIResource {
    * ```
    */
   scanTrigger(
-    params: RecordScanTriggerParams,
+    params?: RecordScanTriggerParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<RecordScanTriggerResponse>;
+  scanTrigger(options?: Core.RequestOptions): Core.APIPromise<RecordScanTriggerResponse>;
+  scanTrigger(
+    params: RecordScanTriggerParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<RecordScanTriggerResponse> {
-    const { zone_id } = params;
+    if (isRequestOptions(params)) {
+      return this.scanTrigger({}, params);
+    }
+    const { zone_id = this._client.zoneId } = params;
     return this._client.post(`/zones/${zone_id}/dns_records/scan/trigger`, options);
   }
 }
@@ -392,6 +459,11 @@ export interface ARecord {
    */
   content?: string;
 
+  /**
+   * Enables private network routing to the origin.
+   */
+  private_routing?: boolean;
+
   /**
    * Whether the record is receiving the performance and security benefits of
    * Cloudflare.
@@ -461,6 +533,11 @@ export interface ARecordParam {
    */
   content?: string;
 
+  /**
+   * Enables private network routing to the origin.
+   */
+  private_routing?: boolean;
+
   /**
    * Whether the record is receiving the performance and security benefits of
    * Cloudflare.
@@ -530,6 +607,11 @@ export interface AAAARecord {
    */
   content?: string;
 
+  /**
+   * Enables private network routing to the origin.
+   */
+  private_routing?: boolean;
+
   /**
    * Whether the record is receiving the performance and security benefits of
    * Cloudflare.
@@ -599,6 +681,11 @@ export interface AAAARecordParam {
    */
   content?: string;
 
+  /**
+   * Enables private network routing to the origin.
+   */
+  private_routing?: boolean;
+
   /**
    * Whether the record is receiving the performance and security benefits of
    * Cloudflare.
@@ -2997,8 +3084,9 @@ export interface MXRecord {
   content?: string;
 
   /**
-   * Required for MX, SRV and URI records; unused by other record types. Records with
-   * lower priorities are preferred.
+   * Required for MX and URI records; ignored for other record types (but may still
+   * be returned by the API). Records with lower priorities are preferred. This field
+   * is to be deprecated in favor of the priority field within the data map.
    */
   priority?: number;
 
@@ -3072,8 +3160,9 @@ export interface MXRecordParam {
   content?: string;
 
   /**
-   * Required for MX, SRV and URI records; unused by other record types. Records with
-   * lower priorities are preferred.
+   * Required for MX and URI records; ignored for other record types (but may still
+   * be returned by the API). Records with lower priorities are preferred. This field
+   * is to be deprecated in favor of the priority field within the data map.
    */
   priority?: number;
 
@@ -3701,30 +3790,30 @@ export namespace Record {
 }
 
 export type RecordResponse =
-  | RecordResponse.ARecord
-  | RecordResponse.AAAARecord
-  | RecordResponse.CNAMERecord
-  | RecordResponse.MXRecord
-  | RecordResponse.NSRecord
-  | RecordResponse.OpenpgpkeyRecord
-  | RecordResponse.PTRRecord
-  | RecordResponse.TXTRecord
-  | RecordResponse.CAARecord
-  | RecordResponse.CERTRecord
-  | RecordResponse.DNSKEYRecord
-  | RecordResponse.DSRecord
-  | RecordResponse.HTTPSRecord
-  | RecordResponse.LOCRecord
-  | RecordResponse.NAPTRRecord
-  | RecordResponse.SMIMEARecord
-  | RecordResponse.SRVRecord
-  | RecordResponse.SSHFPRecord
-  | RecordResponse.SVCBRecord
-  | RecordResponse.TLSARecord
-  | RecordResponse.URIRecord;
+  | RecordResponse.A
+  | RecordResponse.AAAA
+  | RecordResponse.CNAME
+  | RecordResponse.MX
+  | RecordResponse.NS
+  | RecordResponse.Openpgpkey
+  | RecordResponse.PTR
+  | RecordResponse.TXT
+  | RecordResponse.CAA
+  | RecordResponse.CERT
+  | RecordResponse.DNSKEY
+  | RecordResponse.DS
+  | RecordResponse.HTTPS
+  | RecordResponse.LOC
+  | RecordResponse.NAPTR
+  | RecordResponse.SMIMEA
+  | RecordResponse.SRV
+  | RecordResponse.SSHFP
+  | RecordResponse.SVCB
+  | RecordResponse.TLSA
+  | RecordResponse.URI;
 
 export namespace RecordResponse {
-  export interface ARecord extends RecordsAPI.ARecord {
+  export interface A extends RecordsAPI.ARecord {
     /**
      * Identifier.
      */
@@ -3761,7 +3850,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface AAAARecord extends RecordsAPI.AAAARecord {
+  export interface AAAA extends RecordsAPI.AAAARecord {
     /**
      * Identifier.
      */
@@ -3798,7 +3887,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface CNAMERecord extends RecordsAPI.CNAMERecord {
+  export interface CNAME extends RecordsAPI.CNAMERecord {
     /**
      * Identifier.
      */
@@ -3835,7 +3924,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface MXRecord extends RecordsAPI.MXRecord {
+  export interface MX extends RecordsAPI.MXRecord {
     /**
      * Identifier.
      */
@@ -3872,7 +3961,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface NSRecord extends RecordsAPI.NSRecord {
+  export interface NS extends RecordsAPI.NSRecord {
     /**
      * Identifier.
      */
@@ -3909,7 +3998,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface OpenpgpkeyRecord {
+  export interface Openpgpkey {
     /**
      * Identifier.
      */
@@ -3960,7 +4049,7 @@ export namespace RecordResponse {
     /**
      * Settings for the DNS record.
      */
-    settings: OpenpgpkeyRecord.Settings;
+    settings: Openpgpkey.Settings;
 
     /**
      * Custom tags for the DNS record. This field has no effect on DNS responses.
@@ -3990,7 +4079,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export namespace OpenpgpkeyRecord {
+  export namespace Openpgpkey {
     /**
      * Settings for the DNS record.
      */
@@ -4013,7 +4102,7 @@ export namespace RecordResponse {
     }
   }
 
-  export interface PTRRecord extends RecordsAPI.PTRRecord {
+  export interface PTR extends RecordsAPI.PTRRecord {
     /**
      * Identifier.
      */
@@ -4050,7 +4139,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface TXTRecord extends RecordsAPI.TXTRecord {
+  export interface TXT extends RecordsAPI.TXTRecord {
     /**
      * Identifier.
      */
@@ -4087,7 +4176,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface CAARecord extends RecordsAPI.CAARecord {
+  export interface CAA extends RecordsAPI.CAARecord {
     /**
      * Identifier.
      */
@@ -4124,7 +4213,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface CERTRecord extends RecordsAPI.CERTRecord {
+  export interface CERT extends RecordsAPI.CERTRecord {
     /**
      * Identifier.
      */
@@ -4161,7 +4250,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface DNSKEYRecord extends RecordsAPI.DNSKEYRecord {
+  export interface DNSKEY extends RecordsAPI.DNSKEYRecord {
     /**
      * Identifier.
      */
@@ -4198,7 +4287,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface DSRecord extends RecordsAPI.DSRecord {
+  export interface DS extends RecordsAPI.DSRecord {
     /**
      * Identifier.
      */
@@ -4235,7 +4324,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface HTTPSRecord extends RecordsAPI.HTTPSRecord {
+  export interface HTTPS extends RecordsAPI.HTTPSRecord {
     /**
      * Identifier.
      */
@@ -4272,7 +4361,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface LOCRecord extends RecordsAPI.LOCRecord {
+  export interface LOC extends RecordsAPI.LOCRecord {
     /**
      * Identifier.
      */
@@ -4309,7 +4398,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface NAPTRRecord extends RecordsAPI.NAPTRRecord {
+  export interface NAPTR extends RecordsAPI.NAPTRRecord {
     /**
      * Identifier.
      */
@@ -4346,7 +4435,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface SMIMEARecord extends RecordsAPI.SMIMEARecord {
+  export interface SMIMEA extends RecordsAPI.SMIMEARecord {
     /**
      * Identifier.
      */
@@ -4383,7 +4472,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface SRVRecord extends RecordsAPI.SRVRecord {
+  export interface SRV extends RecordsAPI.SRVRecord {
     /**
      * Identifier.
      */
@@ -4420,7 +4509,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface SSHFPRecord extends RecordsAPI.SSHFPRecord {
+  export interface SSHFP extends RecordsAPI.SSHFPRecord {
     /**
      * Identifier.
      */
@@ -4457,7 +4546,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface SVCBRecord extends RecordsAPI.SVCBRecord {
+  export interface SVCB extends RecordsAPI.SVCBRecord {
     /**
      * Identifier.
      */
@@ -4494,7 +4583,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface TLSARecord extends RecordsAPI.TLSARecord {
+  export interface TLSA extends RecordsAPI.TLSARecord {
     /**
      * Identifier.
      */
@@ -4531,7 +4620,7 @@ export namespace RecordResponse {
     tags_modified_on?: string;
   }
 
-  export interface URIRecord extends RecordsAPI.URIRecord {
+  export interface URI extends RecordsAPI.URIRecord {
     /**
      * Identifier.
      */
@@ -4837,8 +4926,9 @@ export namespace SRVRecord {
     port?: number;
 
     /**
-     * Required for MX, SRV and URI records; unused by other record types. Records with
-     * lower priorities are preferred.
+     * Required for MX and URI records; ignored for other record types (but may still
+     * be returned by the API). Records with lower priorities are preferred. This field
+     * is to be deprecated in favor of the priority field within the data map.
      */
     priority?: number;
 
@@ -4932,8 +5022,9 @@ export namespace SRVRecordParam {
     port?: number;
 
     /**
-     * Required for MX, SRV and URI records; unused by other record types. Records with
-     * lower priorities are preferred.
+     * Required for MX and URI records; ignored for other record types (but may still
+     * be returned by the API). Records with lower priorities are preferred. This field
+     * is to be deprecated in favor of the priority field within the data map.
      */
     priority?: number;
 
@@ -5726,8 +5817,9 @@ export interface URIRecord {
   data?: URIRecord.Data;
 
   /**
-   * Required for MX, SRV and URI records; unused by other record types. Records with
-   * lower priorities are preferred.
+   * Required for MX and URI records; ignored for other record types (but may still
+   * be returned by the API). Records with lower priorities are preferred. This field
+   * is to be deprecated in favor of the priority field within the data map.
    */
   priority?: number;
 
@@ -5816,8 +5908,9 @@ export interface URIRecordParam {
   data?: URIRecordParam.Data;
 
   /**
-   * Required for MX, SRV and URI records; unused by other record types. Records with
-   * lower priorities are preferred.
+   * Required for MX and URI records; ignored for other record types (but may still
+   * be returned by the API). Records with lower priorities are preferred. This field
+   * is to be deprecated in favor of the priority field within the data map.
    */
   priority?: number;
 
@@ -6001,7 +6094,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6031,6 +6124,11 @@ export declare namespace RecordCreateParams {
      */
     content?: string;
 
+    /**
+     * Body param: Enables private network routing to the origin.
+     */
+    private_routing?: boolean;
+
     /**
      * Body param: Whether the record is receiving the performance and security
      * benefits of Cloudflare.
@@ -6076,7 +6174,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6106,6 +6204,11 @@ export declare namespace RecordCreateParams {
      */
     content?: string;
 
+    /**
+     * Body param: Enables private network routing to the origin.
+     */
+    private_routing?: boolean;
+
     /**
      * Body param: Whether the record is receiving the performance and security
      * benefits of Cloudflare.
@@ -6151,7 +6254,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6234,7 +6337,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6265,8 +6368,10 @@ export declare namespace RecordCreateParams {
     content?: string;
 
     /**
-     * Body param: Required for MX, SRV and URI records; unused by other record types.
-     * Records with lower priorities are preferred.
+     * Body param: Required for MX and URI records; ignored for other record types (but
+     * may still be returned by the API). Records with lower priorities are preferred.
+     * This field is to be deprecated in favor of the priority field within the data
+     * map.
      */
     priority?: number;
 
@@ -6315,7 +6420,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6390,7 +6495,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6466,7 +6571,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6541,7 +6646,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6621,7 +6726,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6716,7 +6821,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6816,7 +6921,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -6916,7 +7021,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7016,7 +7121,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7111,7 +7216,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7251,7 +7356,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7361,7 +7466,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7461,7 +7566,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7520,8 +7625,9 @@ export declare namespace RecordCreateParams {
       port?: number;
 
       /**
-       * Required for MX, SRV and URI records; unused by other record types. Records with
-       * lower priorities are preferred.
+       * Required for MX and URI records; ignored for other record types (but may still
+       * be returned by the API). Records with lower priorities are preferred. This field
+       * is to be deprecated in favor of the priority field within the data map.
        */
       priority?: number;
 
@@ -7562,7 +7668,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7657,7 +7763,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7752,7 +7858,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7852,7 +7958,7 @@ export declare namespace RecordCreateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -7883,8 +7989,10 @@ export declare namespace RecordCreateParams {
     data?: URIRecord.Data;
 
     /**
-     * Body param: Required for MX, SRV and URI records; unused by other record types.
-     * Records with lower priorities are preferred.
+     * Body param: Required for MX and URI records; ignored for other record types (but
+     * may still be returned by the API). Records with lower priorities are preferred.
+     * This field is to be deprecated in favor of the priority field within the data
+     * map.
      */
     priority?: number;
 
@@ -7973,7 +8081,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8003,6 +8111,11 @@ export declare namespace RecordUpdateParams {
      */
     content?: string;
 
+    /**
+     * Body param: Enables private network routing to the origin.
+     */
+    private_routing?: boolean;
+
     /**
      * Body param: Whether the record is receiving the performance and security
      * benefits of Cloudflare.
@@ -8048,7 +8161,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8078,6 +8191,11 @@ export declare namespace RecordUpdateParams {
      */
     content?: string;
 
+    /**
+     * Body param: Enables private network routing to the origin.
+     */
+    private_routing?: boolean;
+
     /**
      * Body param: Whether the record is receiving the performance and security
      * benefits of Cloudflare.
@@ -8123,7 +8241,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8206,7 +8324,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8237,8 +8355,10 @@ export declare namespace RecordUpdateParams {
     content?: string;
 
     /**
-     * Body param: Required for MX, SRV and URI records; unused by other record types.
-     * Records with lower priorities are preferred.
+     * Body param: Required for MX and URI records; ignored for other record types (but
+     * may still be returned by the API). Records with lower priorities are preferred.
+     * This field is to be deprecated in favor of the priority field within the data
+     * map.
      */
     priority?: number;
 
@@ -8287,7 +8407,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8362,7 +8482,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8438,7 +8558,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8513,7 +8633,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8593,7 +8713,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8688,7 +8808,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8788,7 +8908,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8888,7 +9008,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -8988,7 +9108,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9083,7 +9203,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9223,7 +9343,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9333,7 +9453,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9433,7 +9553,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9492,8 +9612,9 @@ export declare namespace RecordUpdateParams {
       port?: number;
 
       /**
-       * Required for MX, SRV and URI records; unused by other record types. Records with
-       * lower priorities are preferred.
+       * Required for MX and URI records; ignored for other record types (but may still
+       * be returned by the API). Records with lower priorities are preferred. This field
+       * is to be deprecated in favor of the priority field within the data map.
        */
       priority?: number;
 
@@ -9534,7 +9655,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9629,7 +9750,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9724,7 +9845,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9824,7 +9945,7 @@ export declare namespace RecordUpdateParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -9855,8 +9976,10 @@ export declare namespace RecordUpdateParams {
     data?: URIRecord.Data;
 
     /**
-     * Body param: Required for MX, SRV and URI records; unused by other record types.
-     * Records with lower priorities are preferred.
+     * Body param: Required for MX and URI records; ignored for other record types (but
+     * may still be returned by the API). Records with lower priorities are preferred.
+     * This field is to be deprecated in favor of the priority field within the data
+     * map.
      */
     priority?: number;
 
@@ -9921,15 +10044,15 @@ export interface RecordListParams extends V4PagePaginationArrayParams {
   /**
    * Path param: Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 
   /**
-   * Query param:
+   * Query param
    */
   comment?: RecordListParams.Comment;
 
   /**
-   * Query param:
+   * Query param
    */
   content?: RecordListParams.Content;
 
@@ -9947,7 +10070,7 @@ export interface RecordListParams extends V4PagePaginationArrayParams {
   match?: 'any' | 'all';
 
   /**
-   * Query param:
+   * Query param
    */
   name?: RecordListParams.Name;
 
@@ -9972,7 +10095,7 @@ export interface RecordListParams extends V4PagePaginationArrayParams {
   search?: string;
 
   /**
-   * Query param:
+   * Query param
    */
   tag?: RecordListParams.Tag;
 
@@ -10136,27 +10259,27 @@ export interface RecordDeleteParams {
   /**
    * Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 }
 
 export interface RecordBatchParams {
   /**
    * Path param: Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 
   /**
-   * Body param:
+   * Body param
    */
   deletes?: Array<RecordBatchParams.Delete>;
 
   /**
-   * Body param:
+   * Body param
    */
   patches?: Array<BatchPatchParam>;
 
   /**
-   * Body param:
+   * Body param
    */
   posts?: Array<
     | ARecordParam
@@ -10183,7 +10306,7 @@ export interface RecordBatchParams {
   >;
 
   /**
-   * Body param:
+   * Body param
    */
   puts?: Array<BatchPutParam>;
 }
@@ -10294,7 +10417,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -10324,6 +10447,11 @@ export declare namespace RecordEditParams {
      */
     content?: string;
 
+    /**
+     * Body param: Enables private network routing to the origin.
+     */
+    private_routing?: boolean;
+
     /**
      * Body param: Whether the record is receiving the performance and security
      * benefits of Cloudflare.
@@ -10369,7 +10497,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -10399,6 +10527,11 @@ export declare namespace RecordEditParams {
      */
     content?: string;
 
+    /**
+     * Body param: Enables private network routing to the origin.
+     */
+    private_routing?: boolean;
+
     /**
      * Body param: Whether the record is receiving the performance and security
      * benefits of Cloudflare.
@@ -10444,7 +10577,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -10527,7 +10660,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -10558,8 +10691,10 @@ export declare namespace RecordEditParams {
     content?: string;
 
     /**
-     * Body param: Required for MX, SRV and URI records; unused by other record types.
-     * Records with lower priorities are preferred.
+     * Body param: Required for MX and URI records; ignored for other record types (but
+     * may still be returned by the API). Records with lower priorities are preferred.
+     * This field is to be deprecated in favor of the priority field within the data
+     * map.
      */
     priority?: number;
 
@@ -10608,7 +10743,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -10683,7 +10818,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -10759,7 +10894,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -10834,7 +10969,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -10914,7 +11049,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11009,7 +11144,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11109,7 +11244,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11209,7 +11344,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11309,7 +11444,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11404,7 +11539,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11544,7 +11679,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11654,7 +11789,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11754,7 +11889,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11813,8 +11948,9 @@ export declare namespace RecordEditParams {
       port?: number;
 
       /**
-       * Required for MX, SRV and URI records; unused by other record types. Records with
-       * lower priorities are preferred.
+       * Required for MX and URI records; ignored for other record types (but may still
+       * be returned by the API). Records with lower priorities are preferred. This field
+       * is to be deprecated in favor of the priority field within the data map.
        */
       priority?: number;
 
@@ -11855,7 +11991,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -11950,7 +12086,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -12045,7 +12181,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -12145,7 +12281,7 @@ export declare namespace RecordEditParams {
     /**
      * Path param: Identifier.
      */
-    zone_id: string;
+    zone_id?: string;
 
     /**
      * Body param: Complete DNS record name, including the zone name, in Punycode.
@@ -12176,8 +12312,10 @@ export declare namespace RecordEditParams {
     data?: URIRecord.Data;
 
     /**
-     * Body param: Required for MX, SRV and URI records; unused by other record types.
-     * Records with lower priorities are preferred.
+     * Body param: Required for MX and URI records; ignored for other record types (but
+     * may still be returned by the API). Records with lower priorities are preferred.
+     * This field is to be deprecated in favor of the priority field within the data
+     * map.
      */
     priority?: number;
 
@@ -12242,21 +12380,21 @@ export interface RecordExportParams {
   /**
    * Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 }
 
 export interface RecordGetParams {
   /**
    * Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 }
 
 export interface RecordImportParams {
   /**
    * Path param: Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 
   /**
    * Body param: BIND config to import.
@@ -12279,10 +12417,10 @@ export interface RecordScanParams {
   /**
    * Path param: Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 
   /**
-   * Body param:
+   * Body param
    */
   body: unknown;
 }
@@ -12291,17 +12429,17 @@ export interface RecordScanListParams {
   /**
    * Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 }
 
 export interface RecordScanReviewParams {
   /**
    * Path param: Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 
   /**
-   * Body param:
+   * Body param
    */
   accepts?: Array<
     | ARecordParam
@@ -12328,7 +12466,7 @@ export interface RecordScanReviewParams {
   >;
 
   /**
-   * Body param:
+   * Body param
    */
   rejects?: Array<RecordScanReviewParams.Reject>;
 }
@@ -12415,7 +12553,7 @@ export interface RecordScanTriggerParams {
   /**
    * Identifier.
    */
-  zone_id: string;
+  zone_id?: string;
 }
 
 Records.RecordResponsesV4PagePaginationArray = RecordResponsesV4PagePaginationArray;