--- title: Sites --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Magic Transit](https://developers.cloudflare.com/api/resources/magic_transit) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Sites ##### [List Sites](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/methods/list) GET/accounts/{account\_id}/magic/sites ##### [Site Details](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/methods/get) GET/accounts/{account\_id}/magic/sites/{site\_id} ##### [Create a new Site](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/methods/create) POST/accounts/{account\_id}/magic/sites ##### [Update Site](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/methods/update) PUT/accounts/{account\_id}/magic/sites/{site\_id} ##### [Patch Site](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/methods/edit) PATCH/accounts/{account\_id}/magic/sites/{site\_id} ##### [Delete Site](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/methods/delete) DELETE/accounts/{account\_id}/magic/sites/{site\_id} ##### ModelsExpand Collapse

Site object {id, connector\_id, description, 4 more }

id: optional string Identifier maxLength32 Link to this property connector\_id: optional string Magic Connector identifier tag. Link to this property description: optional string Link to this property ha\_mode: optional boolean Site high availability mode. If set to true, the site can have two connectors and runs in high availability mode. Link to this property location: optional SiteLocation { lat, lon } Location of site in latitude and longitude. Link to this property name: optional string The name of the site. Link to this property secondary\_connector\_id: optional string Magic Connector identifier tag. Used when high availability mode is on. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(model)%20site%20%3E%20(schema)>)

SiteLocation object {lat, lon } Location of site in latitude and longitude.

lat: optional string Latitude Link to this property lon: optional string Longitude Link to this property

[Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(model)%20site_location%20%3E%20(schema)>) #### SitesApp Configuration ##### [List App Configs](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/app_configuration/methods/list) GET/accounts/{account\_id}/magic/sites/{site\_id}/app\_configs ##### [Create a new App Config](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/app_configuration/methods/create) POST/accounts/{account\_id}/magic/sites/{site\_id}/app\_configs ##### [Update an App Config](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/app_configuration/methods/update) PUT/accounts/{account\_id}/magic/sites/{site\_id}/app\_configs/{app\_config\_id} ##### [Update an App Config](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/app_configuration/methods/edit) PATCH/accounts/{account\_id}/magic/sites/{site\_id}/app\_configs/{app\_config\_id} ##### [Delete App Config](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/app_configuration/methods/delete) DELETE/accounts/{account\_id}/magic/sites/{site\_id}/app\_configs/{app\_config\_id} ##### ModelsExpand Collapse

AppConfigurationListResponse = object {account\_app\_id, id, breakout, 3 more } or object {managed\_app\_id, id, breakout, 3 more } Traffic decision configuration for an app.

One of the following:

AccountApp object {account\_app\_id, id, breakout, 3 more }

account\_app\_id: string Magic account app ID. Link to this property id: optional string Identifier maxLength32 Link to this property breakout: optional boolean Whether to breakout traffic to the app’s endpoints directly. Null preserves default behavior. Link to this property preferred\_wans: optional array of string WAN interfaces to prefer over default WANs, highest-priority first. Can only be specified for breakout rules (breakout must be true). Link to this property priority: optional number Priority of traffic. 0 is default, anything greater is prioritized. (Currently only 0 and 1 are supported) maximum1 minimum0 Link to this property site\_id: optional string Identifier maxLength32 Link to this property

Link to this property

ManagedApp object {managed\_app\_id, id, breakout, 3 more }

managed\_app\_id: string Managed app ID. Link to this property id: optional string Identifier maxLength32 Link to this property breakout: optional boolean Whether to breakout traffic to the app’s endpoints directly. Null preserves default behavior. Link to this property preferred\_wans: optional array of string WAN interfaces to prefer over default WANs, highest-priority first. Can only be specified for breakout rules (breakout must be true). Link to this property priority: optional number Priority of traffic. 0 is default, anything greater is prioritized. (Currently only 0 and 1 are supported) maximum1 minimum0 Link to this property site\_id: optional string Identifier maxLength32 Link to this property

Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.app_configuration%20%3E%20(model)%20app_configuration_list_response%20%3E%20(schema)>)

AppConfigurationCreateResponse = object {account\_app\_id, id, breakout, 3 more } or object {managed\_app\_id, id, breakout, 3 more } Traffic decision configuration for an app.

One of the following:

AccountApp object {account\_app\_id, id, breakout, 3 more }

Link to this property

ManagedApp object {managed\_app\_id, id, breakout, 3 more }

Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.app_configuration%20%3E%20(model)%20app_configuration_create_response%20%3E%20(schema)>)

AppConfigurationUpdateResponse = object {account\_app\_id, id, breakout, 3 more } or object {managed\_app\_id, id, breakout, 3 more } Traffic decision configuration for an app.

One of the following:

AccountApp object {account\_app\_id, id, breakout, 3 more }

Link to this property

ManagedApp object {managed\_app\_id, id, breakout, 3 more }

Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.app_configuration%20%3E%20(model)%20app_configuration_update_response%20%3E%20(schema)>)

AppConfigurationEditResponse = object {account\_app\_id, id, breakout, 3 more } or object {managed\_app\_id, id, breakout, 3 more } Traffic decision configuration for an app.

One of the following:

AccountApp object {account\_app\_id, id, breakout, 3 more }

Link to this property

ManagedApp object {managed\_app\_id, id, breakout, 3 more }

Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.app_configuration%20%3E%20(model)%20app_configuration_edit_response%20%3E%20(schema)>)

AppConfigurationDeleteResponse = object {account\_app\_id, id, breakout, 3 more } or object {managed\_app\_id, id, breakout, 3 more } Traffic decision configuration for an app.

One of the following:

AccountApp object {account\_app\_id, id, breakout, 3 more }

Link to this property

ManagedApp object {managed\_app\_id, id, breakout, 3 more }

Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.app_configuration%20%3E%20(model)%20app_configuration_delete_response%20%3E%20(schema)>) #### SitesACLs ##### [List Site ACLs](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/acls/methods/list) GET/accounts/{account\_id}/magic/sites/{site\_id}/acls ##### [Site ACL Details](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/acls/methods/get) GET/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Create a new Site ACL](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/acls/methods/create) POST/accounts/{account\_id}/magic/sites/{site\_id}/acls ##### [Update Site ACL](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/acls/methods/update) PUT/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Patch Site ACL](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/acls/methods/edit) PATCH/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Delete Site ACL](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/acls/methods/delete) DELETE/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### ModelsExpand Collapse

ACL object {id, description, forward\_locally, 5 more } Bidirectional ACL policy for network traffic within a site.

id: optional string Identifier maxLength32 Link to this property description: optional string Description for the ACL. Link to this property forward\_locally: optional boolean The desired forwarding action for this ACL policy. If set to “false”, the policy will forward traffic to Cloudflare. If set to “true”, the policy will forward traffic locally on the Magic Connector. If not included in request, will default to false. Link to this property lan\_1: optional ACLConfiguration { lan\_id, lan\_name, port\_ranges, 2 more } Link to this property lan\_2: optional ACLConfiguration { lan\_id, lan\_name, port\_ranges, 2 more } Link to this property name: optional string The name of the ACL. Link to this property

protocols: optional array of AllowedProtocol

One of the following: "tcp" Link to this property "udp" Link to this property "icmp" Link to this property

Link to this property unidirectional: optional boolean The desired traffic direction for this ACL policy. If set to “false”, the policy will allow bidirectional traffic. If set to “true”, the policy will only allow traffic in one direction. If not included in request, will default to false. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.acls%20%3E%20(model)%20acl%20%3E%20(schema)>)

ACLConfiguration object {lan\_id, lan\_name, port\_ranges, 2 more }

lan\_id: string The identifier for the LAN you want to create an ACL policy with. Link to this property lan\_name: optional string The name of the LAN based on the provided lan\_id. Link to this property port\_ranges: optional array of string Array of port ranges on the provided LAN that will be included in the ACL. If no ports or port rangess are provided, communication on any port on this LAN is allowed. Link to this property ports: optional array of number Array of ports on the provided LAN that will be included in the ACL. If no ports or port ranges are provided, communication on any port on this LAN is allowed. Link to this property subnets: optional array of Subnet Array of subnet IPs within the LAN that will be included in the ACL. If no subnets are provided, communication on any subnets on this LAN are allowed. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.acls%20%3E%20(model)%20acl_configuration%20%3E%20(schema)>)

AllowedProtocol = "tcp"or "udp"or "icmp" Array of allowed communication protocols between configured LANs. If no protocols are provided, all protocols are allowed.

One of the following: "tcp" Link to this property "udp" Link to this property "icmp" Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.acls%20%3E%20(model)%20allowed_protocol%20%3E%20(schema)>) Subnet = string A valid IPv4 address. [Link to this property](<#(resource)%20magic_transit.sites.acls%20%3E%20(model)%20subnet%20%3E%20(schema)>) #### SitesLANs ##### [List Site LANs](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/lans/methods/list) GET/accounts/{account\_id}/magic/sites/{site\_id}/lans ##### [Site LAN Details](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/lans/methods/get) GET/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Create a new Site LAN](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/lans/methods/create) POST/accounts/{account\_id}/magic/sites/{site\_id}/lans ##### [Update Site LAN](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/lans/methods/update) PUT/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Patch Site LAN](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/lans/methods/edit) PATCH/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Delete Site LAN](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/lans/methods/delete) DELETE/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### ModelsExpand Collapse

DHCPRelay object {server\_addresses }

server\_addresses: optional array of string List of DHCP server IPs. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.lans%20%3E%20(model)%20dhcp_relay%20%3E%20(schema)>)

DHCPServer object {dhcp\_options, dhcp\_pool\_end, dhcp\_pool\_start, 3 more }

dhcp\_options: optional array of object {code, type, value } Optional list of custom DHCP options to include in DHCP responses. Only valid when DHCP server is enabled.

code: number DHCP option number (1-254). Options 0 and 255 are reserved by RFC 2132. Options 3, 6, and 51 are not allowed because they conflict with connector-managed configuration. maximum254 minimum1 Link to this property

type: "text"or "hex"or "ip"or 3 more The type of the option value. text: a string (max 255 bytes). hex: colon-separated hex bytes (e.g. “01:04:aa:bb:cc”, max 255 bytes). ip: an IPv4 address (e.g. “10.20.30.40”). byte: an unsigned integer 0-255 (1 byte). short: an unsigned integer 0-65535 (2 bytes). integer: an unsigned integer 0-4294967295 (4 bytes).

One of the following: "text" Link to this property "hex" Link to this property "ip" Link to this property "byte" Link to this property "short" Link to this property "integer" Link to this property

Link to this property value: string The option value, interpreted according to the type field. Link to this property

Link to this property dhcp\_pool\_end: optional string A valid IPv4 address. Link to this property dhcp\_pool\_start: optional string A valid IPv4 address. Link to this property Deprecateddns\_server: optional string A valid IPv4 address. Link to this property dns\_servers: optional array of string Link to this property reservations: optional map\[string] Mapping of MAC addresses to IP addresses Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.lans%20%3E%20(model)%20dhcp_server%20%3E%20(schema)>)

LAN object {id, bond\_id, ha\_link, 9 more }

id: optional string Identifier maxLength32 Link to this property bond\_id: optional number Link to this property ha\_link: optional boolean mark true to use this LAN for HA probing. only works for site with HA turned on. only one LAN can be set as the ha\_link. Link to this property is\_breakout: optional boolean mark true to use this LAN for source-based breakout traffic Link to this property is\_prioritized: optional boolean mark true to use this LAN for source-based prioritized traffic Link to this property name: optional string Link to this property nat: optional Nat { static\_prefix } Link to this property physport: optional number Link to this property

routed\_subnets: optional array of RoutedSubnet { next\_hop, prefix, nat }

next\_hop: string A valid IPv4 address. Link to this property prefix: string A valid CIDR notation representing an IP range. Link to this property nat: optional Nat { static\_prefix } Link to this property

Link to this property site\_id: optional string Identifier maxLength32 Link to this property static\_addressing: optional LANStaticAddressing { address, dhcp\_relay, dhcp\_server, 2 more } If the site is not configured in high availability mode, this configuration is optional (if omitted, use DHCP). However, if in high availability mode, static\_address is required along with secondary and virtual address. Link to this property vlan\_tag: optional number VLAN ID. Use zero for untagged. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.lans%20%3E%20(model)%20lan%20%3E%20(schema)>)

LANStaticAddressing object {address, dhcp\_relay, dhcp\_server, 2 more } If the site is not configured in high availability mode, this configuration is optional (if omitted, use DHCP). However, if in high availability mode, static\_address is required along with secondary and virtual address.

address: string A valid CIDR notation representing an IP range. Link to this property dhcp\_relay: optional DHCPRelay { server\_addresses } Link to this property dhcp\_server: optional DHCPServer { dhcp\_options, dhcp\_pool\_end, dhcp\_pool\_start, 3 more } Link to this property secondary\_address: optional string A valid CIDR notation representing an IP range. Link to this property virtual\_address: optional string A valid CIDR notation representing an IP range. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.lans%20%3E%20(model)%20lan_static_addressing%20%3E%20(schema)>)

Nat object {static\_prefix }

static\_prefix: optional string A valid CIDR notation representing an IP range. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.lans%20%3E%20(model)%20nat%20%3E%20(schema)>)

RoutedSubnet object {next\_hop, prefix, nat }

[Link to this property](<#(resource)%20magic_transit.sites.lans%20%3E%20(model)%20routed_subnet%20%3E%20(schema)>) #### SitesWANs ##### [List Site WANs](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/wans/methods/list) GET/accounts/{account\_id}/magic/sites/{site\_id}/wans ##### [Site WAN Details](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/wans/methods/get) GET/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Create a new Site WAN](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/wans/methods/create) POST/accounts/{account\_id}/magic/sites/{site\_id}/wans ##### [Update Site WAN](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/wans/methods/update) PUT/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Patch Site WAN](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/wans/methods/edit) PATCH/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Delete Site WAN](https://developers.cloudflare.com/api/resources/magic_transit/subresources/sites/subresources/wans/methods/delete) DELETE/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### ModelsExpand Collapse

WAN object {id, health\_check\_rate, load\_balance\_inner\_flows, 6 more }

id: optional string Identifier maxLength32 Link to this property

health\_check\_rate: optional "low"or "mid"or "high" Magic WAN health check rate for tunnels created on this link. The default value is mid.

One of the following: "low" Link to this property "mid" Link to this property "high" Link to this property

Link to this property load\_balance\_inner\_flows: optional boolean Link to this property name: optional string Link to this property physport: optional number Link to this property priority: optional number Priority of WAN for traffic loadbalancing. Link to this property site\_id: optional string Identifier maxLength32 Link to this property static\_addressing: optional WANStaticAddressing { address, gateway\_address, secondary\_address } (optional) if omitted, use DHCP. Submit secondary\_address when site is in high availability mode. Link to this property vlan\_tag: optional number VLAN ID. Use zero for untagged. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.wans%20%3E%20(model)%20wan%20%3E%20(schema)>)

WANStaticAddressing object {address, gateway\_address, secondary\_address } (optional) if omitted, use DHCP. Submit secondary\_address when site is in high availability mode.

address: string A valid CIDR notation representing an IP range. Link to this property gateway\_address: string A valid IPv4 address. Link to this property secondary\_address: optional string A valid CIDR notation representing an IP range. Link to this property

[Link to this property](<#(resource)%20magic_transit.sites.wans%20%3E%20(model)%20wan_static_addressing%20%3E%20(schema)>)