PATCH /zones/{zone_id}/cache/origin_cloud_regions
Adds or updates a single IP-to-cloud-region mapping for the zone. Unlike POST, this operation is idempotent — if a mapping for the IP already exists it is overwritten. Returns the complete updated list of all mappings for the zone. Returns 403 (code 1164) when the zone has reached the limit of 3,500 IP mappings.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
zone_id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
region |
String | Yes |
Cloud vendor region identifier. Must be a valid region for the specified vendor as returned by the supported_regions endpoint. |
vendor |
String | Yes |
Cloud vendor hosting the origin. Must be one of the supported vendors. Valid values:
|
ip |
String | Yes |
Origin IP address (IPv4 or IPv6). Normalized to canonical form before storage (RFC 5952 for IPv6). |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.