PUT /zones/{zone_id}/origin/cloud_regions/{origin_ip}
Creates a new IP-to-cloud-region mapping or replaces the existing mapping for the specified IP. PUT is idempotent — calling it repeatedly with the same body produces the same result. The IP path parameter is normalized to canonical form (RFC 5952 for IPv6) before storage. The vendor and region are validated against the list from GET /zones/{zone_id}/origin/cloud_regions/supported_regions. Returns 400 if the origin_ip in the body does not match the URL path parameter. 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 |
|---|---|---|---|
origin_ip |
String | Yes |
Origin IP address to create or replace. |
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:
|
origin_ip |
String | Yes |
Origin IP address (IPv4 or IPv6). For the single PUT endpoint ( |
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.