## Batch create or update origin cloud region mappings `client.cache.originCloudRegions.bulkEdit(OriginCloudRegionBulkEditParamsparams, RequestOptionsoptions?): OriginCloudRegionBulkEditResponse` **patch** `/zones/{zone_id}/cache/origin_cloud_regions/batch` Adds or updates up to 100 IP-to-cloud-region mappings in a single request. Each item is validated independently — valid items are applied and invalid items are returned in the `failed` array. The vendor and region for every item are validated against the list from `GET /zones/{zone_id}/cache/origin_cloud_regions/supported_regions`. ### Parameters - `params: OriginCloudRegionBulkEditParams` - `zone_id: string` Path param: Identifier. - `body: Array` Body param - `ip: string` Origin IP address (IPv4 or IPv6). Normalized to canonical form before storage (RFC 5952 for IPv6). - `region: string` Cloud vendor region identifier. Must be a valid region for the specified vendor as returned by the supported_regions endpoint. - `vendor: "aws" | "azure" | "gcp" | "oci"` Cloud vendor hosting the origin. Must be one of the supported vendors. - `"aws"` - `"azure"` - `"gcp"` - `"oci"` ### Returns - `OriginCloudRegionBulkEditResponse` Response result for a batch origin cloud region operation. - `id: "origin_public_cloud_region"` - `"origin_public_cloud_region"` - `editable: boolean` Whether the setting can be modified by the current user. - `value: Value` - `failed: Array` Items that could not be applied, with error details. - `"origin-ip": string` The origin IP address for this item. - `error?: string` Error message explaining why the item failed. Present only on failed items. - `region?: string` Cloud vendor region identifier. Present on succeeded items for patch operations. - `vendor?: string` Cloud vendor identifier. Present on succeeded items for patch operations. - `succeeded: Array` Items that were successfully applied. - `"origin-ip": string` The origin IP address for this item. - `error?: string` Error message explaining why the item failed. Present only on failed items. - `region?: string` Cloud vendor region identifier. Present on succeeded items for patch operations. - `vendor?: string` Cloud vendor identifier. Present on succeeded items for patch operations. - `modified_on?: string | null` Time the mapping set was last modified. Null when no items were successfully applied. ### Example ```node import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const response = await client.cache.originCloudRegions.bulkEdit({ zone_id: '023e105f4ecef8ad9ca31a8372d0c353', body: [ { ip: '192.0.2.1', region: 'us-east-1', vendor: 'aws', }, { ip: '2001:db8::1', region: 'us-central1', vendor: 'gcp', }, ], }); console.log(response.id); ``` #### Response ```json { "errors": [], "messages": [], "result": { "editable": true, "id": "origin_public_cloud_region", "modified_on": "2026-03-01T12:00:00Z", "value": { "failed": [], "succeeded": [ { "origin-ip": "192.0.2.1", "region": "us-east-1", "vendor": "aws" }, { "origin-ip": "2001:db8::1", "region": "us-central1", "vendor": "gcp" } ] } }, "success": true } ```