POST /zones/{zone_id}/cache/origin_cloud_regions
Adds a single IP-to-cloud-region mapping for the zone. The IP must be a valid IPv4 or IPv6 address and is normalized to canonical form before storage (RFC 5952 for IPv6). Returns 400 (code 1145) if a mapping for that IP already exists — use PATCH to update an existing entry. The vendor and region are validated against the list from GET /zones/{zone_id}/cache/origin_cloud_regions/supported_regions.
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.