--- title: Batch create or replace origin cloud region mappings --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Cache](https://developers.cloudflare.com/api/resources/cache) [Origin Cloud Regions](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Batch create or replace origin cloud region mappings PUT/zones/{zone\_id}/origin/cloud\_regions/batch Upserts up to 100 IP-to-cloud-region mappings in a single request. Items in the request body are created or replaced; mappings not included in the request body are preserved unchanged (this is a merge operation, not a full collection replacement). 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}/origin/cloud_regions/supported_regions`. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### P ath ParametersExpand Collapse zone\_id: string Identifier. maxLength32 [Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20bulk_update%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse

body: array of object {origin\_ip, region, vendor }

origin\_ip: string Origin IP address (IPv4 or IPv6). For the single PUT endpoint (PUT /origin/cloud_regions/{origin_ip}), this field must match the path parameter or the request will be rejected with a 400 error. For the batch PUT endpoint, this field identifies which mapping to upsert. Link to this property region: string Cloud vendor region identifier. Must be a valid region for the specified vendor as returned by the supported\_regions endpoint. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin. Must be one of the supported vendors.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20bulk_update%20%3E%20(params)%200%20%3E%20(param)%20body%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of ResponseInfo { code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20bulk_update%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of ResponseInfo { code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20bulk_update%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20bulk_update%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result: optional object {failed, succeeded } Response result for a batch origin cloud region operation.

failed: array of object {origin\_ip, error, region, vendor } Items that could not be applied, with error details.

origin\_ip: string The origin IP address for this item. Link to this property error: optional string Error message explaining why the item failed. Present only on failed items. Link to this property region: optional string Cloud vendor region identifier. Present on succeeded items (the new value for upsert, the deleted value for delete). Link to this property vendor: optional string Cloud vendor identifier. Present on succeeded items (the new value for upsert, the deleted value for delete). Link to this property

Link to this property

succeeded: array of object {origin\_ip, error, region, vendor } Items that were successfully applied.

Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20bulk_update%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Batch create or replace origin cloud region mappings HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/zones/$ZONE_ID/origin/cloud_regions/batch \ -X PUT \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '[ { "origin_ip": "192.0.2.1", "region": "us-east-1", "vendor": "aws" }, { "origin_ip": "2001:db8::1", "region": "us-central1", "vendor": "gcp" } ]' ``` 200 example 4XX example ``` { "errors": [], "messages": [], "result": { "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 } ``` ``` { "errors": [ { "code": 1164, "message": "Maximum number of IP mappings configured for zone." } ], "messages": [], "result": null, "success": false } ``` ##### Returns Examples 200 example 4XX example ``` { "errors": [], "messages": [], "result": { "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 } ``` ``` { "errors": [ { "code": 1164, "message": "Maximum number of IP mappings configured for zone." } ], "messages": [], "result": null, "success": false } ```