{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a new Zero Trust Gateway location.","properties":{"path":{"type":"object","properties":{"account_id":{"$ref":"#/definitions/zero-trust-gateway_identifier-2"}},"required":["account_id"],"additionalProperties":false},"body":{"type":"object","properties":{"client_default":{"$ref":"#/definitions/zero-trust-gateway_client-default"},"dns64_enabled":{"$ref":"#/definitions/zero-trust-gateway_dns64-enabled"},"dns_destination_ips_id":{"$ref":"#/definitions/zero-trust-gateway_dns-destination-ips-id-write"},"ecs_support":{"$ref":"#/definitions/zero-trust-gateway_ecs-support"},"endpoints":{"$ref":"#/definitions/zero-trust-gateway_endpoints"},"max_ttl":{"$ref":"#/definitions/zero-trust-gateway_max-ttl"},"name":{"$ref":"#/definitions/zero-trust-gateway_name-2"},"networks":{"$ref":"#/definitions/zero-trust-gateway_ipv4_networks"}},"required":["name"]}},"required":["path","body"],"additionalProperties":false,"definitions":{"zero-trust-gateway_identifier-2":{"description":"Specify the Cloudflare account identifier.","type":"string","examples":["699d98642c564d2e855e9661899b7252"]},"zero-trust-gateway_client-default":{"description":"Indicate whether this location is the default location.","type":"boolean","default":false,"examples":[false]},"zero-trust-gateway_dns64-enabled":{"description":"Enable DNS64 synthesis for DNS queries matched to this location. When updating a location, omitting this field resets it to false.","type":"boolean","default":false,"examples":[false]},"zero-trust-gateway_dns-destination-ips-id-write":{"description":"Specify the identifier of the pair of IPv4 addresses assigned to this location. When creating a location, if this field is absent or set to null, the pair of shared IPv4 addresses (0e4a32c6-6fb8-4858-9296-98f51631e8e6) is auto-assigned. When updating a location, if this field is absent or set to null, the pre-assigned pair remains unchanged.","type":"string","examples":["0e4a32c6-6fb8-4858-9296-98f51631e8e6"]},"zero-trust-gateway_ecs-support":{"description":"Indicate whether the location must resolve EDNS queries.","type":"boolean","default":false,"examples":[false]},"zero-trust-gateway_endpoints":{"description":"Configure the destination endpoints for this location.","type":["object","null"],"properties":{"doh":{"$ref":"#/definitions/zero-trust-gateway_doh_endpoint"},"dot":{"$ref":"#/definitions/zero-trust-gateway_dot_endpoint"},"ipv4":{"$ref":"#/definitions/zero-trust-gateway_ipv4_endpoint"},"ipv6":{"$ref":"#/definitions/zero-trust-gateway_ipv6_endpoint"}},"required":["ipv4","ipv6","doh","dot"]},"zero-trust-gateway_max-ttl":{"description":"Controls how DNS response TTLs are capped for this location relative to the account `max_ttl_secs` setting. Omitting `max_ttl` on update resets it to `inherit`.","type":["object","null"],"properties":{"mode":{"description":"`inherit` uses the account `max_ttl_secs`. `override` uses this location's `ttl_secs`. `disabled` leaves returned TTLs unchanged.","type":"string","enum":["inherit","override","disabled"],"examples":["override"]},"ttl_secs":{"description":"Location-specific cap on DNS response TTLs, in seconds. Required when `mode` is `override`. Must be omitted when `mode` is `inherit` or `disabled`.","type":["integer","null"],"maximum":36000,"minimum":60,"examples":[3600]}},"default":{"mode":"inherit"},"required":["mode"]},"zero-trust-gateway_name-2":{"description":"Specify the location name.","type":"string","examples":["Austin Office Location"]},"zero-trust-gateway_ipv4_networks":{"description":"Specify the list of network ranges from which requests at this location originate. The list takes effect only if it is non-empty and the IPv4 endpoint is enabled for this location.","type":["array","null"],"items":{"$ref":"#/definitions/zero-trust-gateway_ipv4_network"}},"zero-trust-gateway_doh_endpoint":{"type":"object","properties":{"enabled":{"description":"Indicate whether the DOH endpoint is enabled for this location.","type":"boolean","examples":[true]},"networks":{"$ref":"#/definitions/zero-trust-gateway_ip_networks"},"require_token":{"description":"Specify whether the DOH endpoint requires user identity authentication.","type":"boolean","examples":[true]}}},"zero-trust-gateway_dot_endpoint":{"type":"object","properties":{"enabled":{"description":"Indicate whether the DOT endpoint is enabled for this location.","type":"boolean","examples":[true]},"networks":{"$ref":"#/definitions/zero-trust-gateway_ip_networks"}}},"zero-trust-gateway_ipv4_endpoint":{"type":"object","properties":{"enabled":{"description":"Indicate whether the IPv4 endpoint is enabled for this location.","type":"boolean","examples":[true]}}},"zero-trust-gateway_ipv6_endpoint":{"type":"object","properties":{"enabled":{"description":"Indicate whether the IPV6 endpoint is enabled for this location.","type":"boolean","examples":[true]},"networks":{"$ref":"#/definitions/zero-trust-gateway_ipv6_networks"}}},"zero-trust-gateway_ipv4_network":{"type":"object","properties":{"network":{"description":"Specify the IPv4 address or IPv4 CIDR. Limit IPv4 CIDRs to a maximum of /24.","type":"string","examples":["192.0.2.1/32"]}},"required":["network"]},"zero-trust-gateway_ip_networks":{"description":"Specify the list of allowed source IP network ranges for this endpoint. When the list is empty, the endpoint allows all source IPs. The list takes effect only if the endpoint is enabled for this location.","type":["array","null"],"items":{"$ref":"#/definitions/zero-trust-gateway_ip_network"}},"zero-trust-gateway_ipv6_networks":{"description":"Specify the list of allowed source IPv6 network ranges for this endpoint. When the list is empty, the endpoint allows all source IPs. The list takes effect only if the endpoint is enabled for this location.","type":["array","null"],"items":{"$ref":"#/definitions/zero-trust-gateway_ipv6_network"}},"zero-trust-gateway_ip_network":{"type":"object","properties":{"network":{"description":"Specify the IP address or IP CIDR.","type":"string","examples":["2001:85a3::/64"]}},"required":["network"]},"zero-trust-gateway_ipv6_network":{"type":"object","properties":{"network":{"description":"Specify the IPv6 address or IPv6 CIDR.","type":"string","examples":["2001:85a3::/64"]}},"required":["network"]}}},"name":"Create a Zero Trust Gateway location","id":"cloudflare.zero-trust-gateway-locations-create-zero-trust-gateway-location","example":{"path":{"account_id":"699d98642c564d2e855e9661899b7252"},"body":{"name":"Austin Office Location"}},"maxRequests":1,"summary":false}}