cloudflare 6.0.0 → 6.1.0

package/src/resources/zero-trust/devices/deployment-groups.ts

@@ -0,0 +1,302 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
+import { V4PagePaginationArray, type V4PagePaginationArrayParams } from '../../../pagination';
+
+export class DeploymentGroups extends APIResource {
+  /**
+   * Creates a new deployment group. Policy IDs must be unique across all deployment
+   * groups. This endpoint is in Beta.
+   *
+   * @example
+   * ```ts
+   * const deploymentGroup =
+   *   await client.zeroTrust.devices.deploymentGroups.create({
+   *     account_id: 'account_id',
+   *     name: 'Engineering Ring 0',
+   *     version_config: [
+   *       {
+   *         target_environment: 'windows',
+   *         version: '2026.5.234.0',
+   *       },
+   *     ],
+   *   });
+   * ```
+   */
+  create(
+    params: DeploymentGroupCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DeploymentGroup> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.post(`/accounts/${account_id}/devices/deployment-groups`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: DeploymentGroup }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Lists all deployment groups for an account. Use deployment groups to assign
+   * target WARP client versions to specific devices. This endpoint is in Beta.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const deploymentGroup of client.zeroTrust.devices.deploymentGroups.list(
+   *   { account_id: 'account_id' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: DeploymentGroupListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<DeploymentGroupsV4PagePaginationArray, DeploymentGroup> {
+    const { account_id, ...query } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/devices/deployment-groups`,
+      DeploymentGroupsV4PagePaginationArray,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Deletes a deployment group. Associated policies no longer apply and devices stop
+   * receiving version targets. This endpoint is in Beta.
+   *
+   * @example
+   * ```ts
+   * const deploymentGroup =
+   *   await client.zeroTrust.devices.deploymentGroups.delete(
+   *     'group_id',
+   *     { account_id: 'account_id' },
+   *   );
+   * ```
+   */
+  delete(
+    groupId: string,
+    params: DeploymentGroupDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DeploymentGroupDeleteResponse> {
+    const { account_id } = params;
+    return (
+      this._client.delete(
+        `/accounts/${account_id}/devices/deployment-groups/${groupId}`,
+        options,
+      ) as Core.APIPromise<{ result: DeploymentGroupDeleteResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Updates a deployment group. Returns 409 if any newly added policy IDs already
+   * belong to another deployment group. This endpoint is in Beta.
+   *
+   * @example
+   * ```ts
+   * const deploymentGroup =
+   *   await client.zeroTrust.devices.deploymentGroups.edit(
+   *     'group_id',
+   *     { account_id: 'account_id' },
+   *   );
+   * ```
+   */
+  edit(
+    groupId: string,
+    params: DeploymentGroupEditParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DeploymentGroup> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.patch(`/accounts/${account_id}/devices/deployment-groups/${groupId}`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: DeploymentGroup }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Fetches a single deployment group by its ID. This endpoint is in Beta.
+   *
+   * @example
+   * ```ts
+   * const deploymentGroup =
+   *   await client.zeroTrust.devices.deploymentGroups.get(
+   *     'group_id',
+   *     { account_id: 'account_id' },
+   *   );
+   * ```
+   */
+  get(
+    groupId: string,
+    params: DeploymentGroupGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<DeploymentGroup> {
+    const { account_id } = params;
+    return (
+      this._client.get(
+        `/accounts/${account_id}/devices/deployment-groups/${groupId}`,
+        options,
+      ) as Core.APIPromise<{ result: DeploymentGroup }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export class DeploymentGroupsV4PagePaginationArray extends V4PagePaginationArray<DeploymentGroup> {}
+
+export interface DeploymentGroup {
+  /**
+   * The ID of the deployment group.
+   */
+  id: string;
+
+  /**
+   * The RFC3339Nano timestamp when the deployment group was created.
+   */
+  created_at: string;
+
+  /**
+   * A user-friendly name for the deployment group.
+   */
+  name: string;
+
+  /**
+   * The RFC3339Nano timestamp when the deployment group was last updated.
+   */
+  updated_at: string;
+
+  /**
+   * Contains version configurations for different target environments.
+   */
+  version_config: Array<DeploymentGroup.VersionConfig>;
+
+  /**
+   * Contains a list of policy IDs assigned to this deployment group.
+   */
+  policy_ids?: Array<string> | null;
+}
+
+export namespace DeploymentGroup {
+  export interface VersionConfig {
+    /**
+     * The target environment for the client version (e.g., windows, macos).
+     */
+    target_environment: string | null;
+
+    /**
+     * The specific client version to deploy.
+     */
+    version: string;
+  }
+}
+
+export interface DeploymentGroupDeleteResponse {
+  /**
+   * The ID of a deleted deployment group.
+   */
+  id?: string;
+}
+
+export interface DeploymentGroupCreateParams {
+  /**
+   * Path param
+   */
+  account_id: string;
+
+  /**
+   * Body param: A user-friendly name for the deployment group.
+   */
+  name: string;
+
+  /**
+   * Body param: Contains at least one version configuration.
+   */
+  version_config: Array<DeploymentGroupCreateParams.VersionConfig>;
+
+  /**
+   * Body param: Contains an optional list of policy IDs assigned to a group.
+   */
+  policy_ids?: Array<string>;
+}
+
+export namespace DeploymentGroupCreateParams {
+  export interface VersionConfig {
+    /**
+     * The target environment for the client version (e.g., windows, macos).
+     */
+    target_environment: string | null;
+
+    /**
+     * The specific client version to deploy.
+     */
+    version: string;
+  }
+}
+
+export interface DeploymentGroupListParams extends V4PagePaginationArrayParams {
+  /**
+   * Path param
+   */
+  account_id: string;
+}
+
+export interface DeploymentGroupDeleteParams {
+  account_id: string;
+}
+
+export interface DeploymentGroupEditParams {
+  /**
+   * Path param
+   */
+  account_id: string;
+
+  /**
+   * Body param: A user-friendly name for the deployment group.
+   */
+  name?: string;
+
+  /**
+   * Body param: Replaces the entire list of policy IDs.
+   */
+  policy_ids?: Array<string>;
+
+  /**
+   * Body param: Replaces the entire version_config array.
+   */
+  version_config?: Array<DeploymentGroupEditParams.VersionConfig>;
+}
+
+export namespace DeploymentGroupEditParams {
+  export interface VersionConfig {
+    /**
+     * The target environment for the client version (e.g., windows, macos).
+     */
+    target_environment: string | null;
+
+    /**
+     * The specific client version to deploy.
+     */
+    version: string;
+  }
+}
+
+export interface DeploymentGroupGetParams {
+  account_id: string;
+}
+
+DeploymentGroups.DeploymentGroupsV4PagePaginationArray = DeploymentGroupsV4PagePaginationArray;
+
+export declare namespace DeploymentGroups {
+  export {
+    type DeploymentGroup as DeploymentGroup,
+    type DeploymentGroupDeleteResponse as DeploymentGroupDeleteResponse,
+    DeploymentGroupsV4PagePaginationArray as DeploymentGroupsV4PagePaginationArray,
+    type DeploymentGroupCreateParams as DeploymentGroupCreateParams,
+    type DeploymentGroupListParams as DeploymentGroupListParams,
+    type DeploymentGroupDeleteParams as DeploymentGroupDeleteParams,
+    type DeploymentGroupEditParams as DeploymentGroupEditParams,
+    type DeploymentGroupGetParams as DeploymentGroupGetParams,
+  };
+}

package/src/resources/zero-trust/devices/devices.ts

@@ -2,6 +2,18 @@
 
 import { APIResource } from '../../../resource';
 import * as Core from '../../../core';
+import * as DeploymentGroupsAPI from './deployment-groups';
+import {
+  DeploymentGroup,
+  DeploymentGroupCreateParams,
+  DeploymentGroupDeleteParams,
+  DeploymentGroupDeleteResponse,
+  DeploymentGroupEditParams,
+  DeploymentGroupGetParams,
+  DeploymentGroupListParams,
+  DeploymentGroups,
+  DeploymentGroupsV4PagePaginationArray,
+} from './deployment-groups';
 import * as DevicesDevicesAPI from './devices_';
 import {
   DeviceDeleteParams,
@@ -142,6 +154,9 @@ export class Devices extends APIResource {
   registrations: RegistrationsAPI.Registrations = new RegistrationsAPI.Registrations(this._client);
   dexTests: DEXTestsAPI.DEXTests = new DEXTestsAPI.DEXTests(this._client);
   ipProfiles: IPProfilesAPI.IPProfiles = new IPProfilesAPI.IPProfiles(this._client);
+  deploymentGroups: DeploymentGroupsAPI.DeploymentGroups = new DeploymentGroupsAPI.DeploymentGroups(
+    this._client,
+  );
   networks: NetworksAPI.Networks = new NetworksAPI.Networks(this._client);
   fleetStatus: FleetStatusAPI.FleetStatus = new FleetStatusAPI.FleetStatus(this._client);
   policies: PoliciesAPI.Policies = new PoliciesAPI.Policies(this._client);
@@ -457,6 +472,8 @@ Devices.DEXTests = DEXTests;
 Devices.DEXTestListResponsesV4PagePaginationArray = DEXTestListResponsesV4PagePaginationArray;
 Devices.IPProfiles = IPProfiles;
 Devices.IPProfilesSinglePage = IPProfilesSinglePage;
+Devices.DeploymentGroups = DeploymentGroups;
+Devices.DeploymentGroupsV4PagePaginationArray = DeploymentGroupsV4PagePaginationArray;
 Devices.Networks = Networks;
 Devices.DeviceNetworksSinglePage = DeviceNetworksSinglePage;
 Devices.FleetStatus = FleetStatus;
@@ -536,6 +553,18 @@ export declare namespace Devices {
     type IPProfileGetParams as IPProfileGetParams,
   };
 
+  export {
+    DeploymentGroups as DeploymentGroups,
+    type DeploymentGroup as DeploymentGroup,
+    type DeploymentGroupDeleteResponse as DeploymentGroupDeleteResponse,
+    DeploymentGroupsV4PagePaginationArray as DeploymentGroupsV4PagePaginationArray,
+    type DeploymentGroupCreateParams as DeploymentGroupCreateParams,
+    type DeploymentGroupListParams as DeploymentGroupListParams,
+    type DeploymentGroupDeleteParams as DeploymentGroupDeleteParams,
+    type DeploymentGroupEditParams as DeploymentGroupEditParams,
+    type DeploymentGroupGetParams as DeploymentGroupGetParams,
+  };
+
   export {
     Networks as Networks,
     type DeviceNetwork as DeviceNetwork,

package/src/resources/zero-trust/devices/index.ts

@@ -16,6 +16,17 @@ export {
   type DEXTestDeleteParams,
   type DEXTestGetParams,
 } from './dex-tests';
+export {
+  DeploymentGroupsV4PagePaginationArray,
+  DeploymentGroups,
+  type DeploymentGroup,
+  type DeploymentGroupDeleteResponse,
+  type DeploymentGroupCreateParams,
+  type DeploymentGroupListParams,
+  type DeploymentGroupDeleteParams,
+  type DeploymentGroupEditParams,
+  type DeploymentGroupGetParams,
+} from './deployment-groups';
 export {
   DeviceListResponsesCursorPagination,
   type DeviceListResponse,

package/src/resources/zero-trust/identity-providers/scim/groups.ts

@@ -44,15 +44,21 @@ export interface GroupListParams extends V4PagePaginationArrayParams {
 
   /**
    * Query param: The unique Cloudflare-generated Id of the SCIM Group resource; also
-   * known as the "Id".
+   * known as the "Id". Pass once for a single lookup (`?cf_resource_id=A`) or repeat
+   * the parameter (`?cf_resource_id=A&cf_resource_id=B`) to look up multiple groups
+   * in one request, up to 50 values. Mutually exclusive with `idp_resource_id`,
+   * `name`, `search_contains`, and `search_starts_with`.
    */
-  cf_resource_id?: string;
+  cf_resource_id?: Array<string>;
 
   /**
    * Query param: The IdP-generated Id of the SCIM Group resource; also known as the
-   * "external Id".
+   * "external Id". Pass once for a single lookup (`?idp_resource_id=A`) or repeat
+   * the parameter (`?idp_resource_id=A&idp_resource_id=B`) to look up multiple
+   * groups in one request, up to 50 values. Mutually exclusive with
+   * `cf_resource_id`, `name`, `search_contains`, and `search_starts_with`.
    */
-  idp_resource_id?: string;
+  idp_resource_id?: Array<string>;
 
   /**
    * Query param: The display name of the SCIM Group resource.

package/src/resources/zero-trust/identity-providers/scim/users.ts

@@ -44,9 +44,12 @@ export interface UserListParams extends V4PagePaginationArrayParams {
 
   /**
    * Query param: The unique Cloudflare-generated Id of the SCIM User resource; also
-   * known as the "Id".
+   * known as the "Id". Pass once for a single lookup (`?cf_resource_id=A`) or repeat
+   * the parameter (`?cf_resource_id=A&cf_resource_id=B`) to look up multiple users
+   * in one request, up to 50 values. Mutually exclusive with `idp_resource_id`,
+   * `username`, `email`, `name`, `search_contains`, and `search_starts_with`.
    */
-  cf_resource_id?: string;
+  cf_resource_id?: Array<string>;
 
   /**
    * Query param: The email address of the SCIM User resource.
@@ -55,9 +58,12 @@ export interface UserListParams extends V4PagePaginationArrayParams {
 
   /**
    * Query param: The IdP-generated Id of the SCIM User resource; also known as the
-   * "external Id".
+   * "external Id". Pass once for a single lookup (`?idp_resource_id=A`) or repeat
+   * the parameter (`?idp_resource_id=A&idp_resource_id=B`) to look up multiple users
+   * in one request, up to 50 values. Mutually exclusive with `cf_resource_id`,
+   * `username`, `email`, `name`, `search_contains`, and `search_starts_with`.
    */
-  idp_resource_id?: string;
+  idp_resource_id?: Array<string>;
 
   /**
    * Query param: The name of the SCIM User resource.

package/src/resources/zones/settings.ts

@@ -1596,6 +1596,7 @@ export type SettingEditResponse =
   | SettingEditResponse.ZonesSchemasResponseBuffering
   | SettingEditResponse.ZonesSchemasRocketLoader
   | SettingEditResponse.ZonesSchemasAutomaticPlatformOptimization
+  | SettingEditResponse.ZonesSearchForAgents
   | SecurityHeaders
   | SettingEditResponse.ZonesSchemasSecurityLevel
   | ServerSideExcludes
@@ -2372,6 +2373,35 @@ export namespace SettingEditResponse {
     modified_on?: string | null;
   }
 
+  /**
+   * When enabled, Cloudflare provisions an AI Search instance for the zone and
+   * exposes a /.well-known/ai-search endpoint that AI agents can query. Markdown
+   * responses also receive an agent: YAML capability block advertising the search
+   * endpoint.
+   */
+  export interface ZonesSearchForAgents {
+    /**
+     * ID of the zone setting.
+     */
+    id: 'search_for_agents';
+
+    /**
+     * Current value of the zone setting.
+     */
+    value: 'off' | 'on';
+
+    /**
+     * Whether or not this setting can be modified for this zone (based on your
+     * Cloudflare plan level).
+     */
+    editable?: true | false;
+
+    /**
+     * last time this setting was modified.
+     */
+    modified_on?: string | null;
+  }
+
   /**
    * Choose the appropriate security profile for your website, which will
    * automatically adjust each of the security settings. If you choose to customize
@@ -2697,6 +2727,7 @@ export type SettingGetResponse =
   | SettingGetResponse.ZonesSchemasResponseBuffering
   | SettingGetResponse.ZonesSchemasRocketLoader
   | SettingGetResponse.ZonesSchemasAutomaticPlatformOptimization
+  | SettingGetResponse.ZonesSearchForAgents
   | SecurityHeaders
   | SettingGetResponse.ZonesSchemasSecurityLevel
   | ServerSideExcludes
@@ -3473,6 +3504,35 @@ export namespace SettingGetResponse {
     modified_on?: string | null;
   }
 
+  /**
+   * When enabled, Cloudflare provisions an AI Search instance for the zone and
+   * exposes a /.well-known/ai-search endpoint that AI agents can query. Markdown
+   * responses also receive an agent: YAML capability block advertising the search
+   * endpoint.
+   */
+  export interface ZonesSearchForAgents {
+    /**
+     * ID of the zone setting.
+     */
+    id: 'search_for_agents';
+
+    /**
+     * Current value of the zone setting.
+     */
+    value: 'off' | 'on';
+
+    /**
+     * Whether or not this setting can be modified for this zone (based on your
+     * Cloudflare plan level).
+     */
+    editable?: true | false;
+
+    /**
+     * last time this setting was modified.
+     */
+    modified_on?: string | null;
+  }
+
   /**
    * Choose the appropriate security profile for your website, which will
    * automatically adjust each of the security settings. If you choose to customize

package/src/resources/zones/zones.ts

@@ -608,6 +608,13 @@ export interface ZoneListParams extends V4PagePaginationArrayParams {
    * Specify a zone status to filter by.
    */
   status?: 'initializing' | 'pending' | 'active' | 'moved';
+
+  /**
+   * Zone types to filter by. Multiple types can be specified as a comma-separated
+   * list (e.g., ?type=full,partial,secondary). When this parameter is not provided,
+   * zones with type "internal" are excluded from the results.
+   */
+  type?: Array<'full' | 'partial' | 'secondary' | 'internal'>;
 }
 
 export namespace ZoneListParams {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '6.0.0'; // x-release-please-version
+export const VERSION = '6.1.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.0.0";
+export declare const VERSION = "6.1.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '6.0.0'; // x-release-please-version
+exports.VERSION = '6.1.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '6.0.0'; // x-release-please-version
+export const VERSION = '6.1.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map