--- title: Sites --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Magic Transit](https://developers.cloudflare.com/api/go/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/go/resources/magic_transit/subresources/sites/methods/list) client.MagicTransit.Sites.List(ctx, params) (\*SinglePage\[[Site]()], error) GET/accounts/{account\_id}/magic/sites ##### [Site Details](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/methods/get) client.MagicTransit.Sites.Get(ctx, siteID, params) (\*[Site](), error) GET/accounts/{account\_id}/magic/sites/{site\_id} ##### [Create a new Site](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/methods/create) client.MagicTransit.Sites.New(ctx, params) (\*[Site](), error) POST/accounts/{account\_id}/magic/sites ##### [Update Site](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/methods/update) client.MagicTransit.Sites.Update(ctx, siteID, params) (\*[Site](), error) PUT/accounts/{account\_id}/magic/sites/{site\_id} ##### [Patch Site](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/methods/edit) client.MagicTransit.Sites.Edit(ctx, siteID, params) (\*[Site](), error) PATCH/accounts/{account\_id}/magic/sites/{site\_id} ##### [Delete Site](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/methods/delete) client.MagicTransit.Sites.Delete(ctx, siteID, body) (\*[Site](), error) DELETE/accounts/{account\_id}/magic/sites/{site\_id} ##### ModelsExpand Collapse

type Site struct{…}

ID stringOptional Identifier maxLength32 Link to this property ConnectorID stringOptional Magic Connector identifier tag. Link to this property Description stringOptional Link to this property HaMode boolOptional 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 SiteLocationOptional Location of site in latitude and longitude. Link to this property Name stringOptional The name of the site. Link to this property SecondaryConnectorID stringOptional 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)>)

type SiteLocation struct{…} Location of site in latitude and longitude.

Lat stringOptional Latitude Link to this property Lon stringOptional 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 #### SitesACLs ##### [List Site ACLs](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/acls/methods/list) client.MagicTransit.Sites.ACLs.List(ctx, siteID, query) (\*SinglePage\[[ACL]()], error) GET/accounts/{account\_id}/magic/sites/{site\_id}/acls ##### [Site ACL Details](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/acls/methods/get) client.MagicTransit.Sites.ACLs.Get(ctx, siteID, aclID, query) (\*[ACL](), error) GET/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Create a new Site ACL](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/acls/methods/create) client.MagicTransit.Sites.ACLs.New(ctx, siteID, params) (\*[ACL](), error) POST/accounts/{account\_id}/magic/sites/{site\_id}/acls ##### [Update Site ACL](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/acls/methods/update) client.MagicTransit.Sites.ACLs.Update(ctx, siteID, aclID, params) (\*[ACL](), error) PUT/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Patch Site ACL](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/acls/methods/edit) client.MagicTransit.Sites.ACLs.Edit(ctx, siteID, aclID, params) (\*[ACL](), error) PATCH/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Delete Site ACL](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/acls/methods/delete) client.MagicTransit.Sites.ACLs.Delete(ctx, siteID, aclID, body) (\*[ACL](), error) DELETE/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### ModelsExpand Collapse

type ACL struct{…} Bidirectional ACL policy for network traffic within a site.

ID stringOptional Identifier maxLength32 Link to this property Description stringOptional Description for the ACL. Link to this property ForwardLocally boolOptional 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 LAN1 ACLConfigurationOptional Link to this property LAN2 ACLConfigurationOptional Link to this property Name stringOptional The name of the ACL. Link to this property

Protocols \[]AllowedProtocolOptional

One of the following: const AllowedProtocolTCP AllowedProtocol = "tcp" Link to this property const AllowedProtocolUdp AllowedProtocol = "udp" Link to this property const AllowedProtocolIcmp AllowedProtocol = "icmp" Link to this property

Link to this property Unidirectional boolOptional 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)>)

type ACLConfiguration struct{…}

LANID string The identifier for the LAN you want to create an ACL policy with. Link to this property LANName stringOptional The name of the LAN based on the provided lan\_id. Link to this property PortRanges \[]stringOptional 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 \[]int64Optional 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 \[]SubnetOptional 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)>)

type AllowedProtocol string Array of allowed communication protocols between configured LANs. If no protocols are provided, all protocols are allowed.

[Link to this property](<#(resource)%20magic_transit.sites.acls%20%3E%20(model)%20allowed_protocol%20%3E%20(schema)>) type 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/go/resources/magic_transit/subresources/sites/subresources/lans/methods/list) client.MagicTransit.Sites.LANs.List(ctx, siteID, query) (\*SinglePage\[[LAN]()], error) GET/accounts/{account\_id}/magic/sites/{site\_id}/lans ##### [Site LAN Details](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/lans/methods/get) client.MagicTransit.Sites.LANs.Get(ctx, siteID, lanID, query) (\*[LAN](), error) GET/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Create a new Site LAN](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/lans/methods/create) client.MagicTransit.Sites.LANs.New(ctx, siteID, params) (\*SinglePage\[[LAN]()], error) POST/accounts/{account\_id}/magic/sites/{site\_id}/lans ##### [Update Site LAN](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/lans/methods/update) client.MagicTransit.Sites.LANs.Update(ctx, siteID, lanID, params) (\*[LAN](), error) PUT/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Patch Site LAN](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/lans/methods/edit) client.MagicTransit.Sites.LANs.Edit(ctx, siteID, lanID, params) (\*[LAN](), error) PATCH/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Delete Site LAN](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/lans/methods/delete) client.MagicTransit.Sites.LANs.Delete(ctx, siteID, lanID, body) (\*[LAN](), error) DELETE/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### ModelsExpand Collapse

type DHCPRelay struct{…}

ServerAddresses \[]stringOptional 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)>)

type DHCPServer struct{…}

DHCPOptions \[]DHCPServerDHCPOptionOptional Optional list of custom DHCP options to include in DHCP responses. Only valid when DHCP server is enabled.

Code int64 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 DHCPServerDHCPOptionsType 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: const DHCPServerDHCPOptionsTypeText DHCPServerDHCPOptionsType = "text" Link to this property const DHCPServerDHCPOptionsTypeHex DHCPServerDHCPOptionsType = "hex" Link to this property const DHCPServerDHCPOptionsTypeIP DHCPServerDHCPOptionsType = "ip" Link to this property const DHCPServerDHCPOptionsTypeByte DHCPServerDHCPOptionsType = "byte" Link to this property const DHCPServerDHCPOptionsTypeShort DHCPServerDHCPOptionsType = "short" Link to this property const DHCPServerDHCPOptionsTypeInteger DHCPServerDHCPOptionsType = "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 DHCPPoolEnd stringOptional A valid IPv4 address. Link to this property DHCPPoolStart stringOptional A valid IPv4 address. Link to this property DeprecatedDNSServer stringOptional A valid IPv4 address. Link to this property DNSServers \[]stringOptional Link to this property Reservations map\[string, string]Optional 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)>)

type LAN struct{…}

ID stringOptional Identifier maxLength32 Link to this property BondID int64Optional Link to this property HaLink boolOptional 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 IsBreakout boolOptional mark true to use this LAN for source-based breakout traffic Link to this property IsPrioritized boolOptional mark true to use this LAN for source-based prioritized traffic Link to this property Name stringOptional Link to this property Nat NatOptional Link to this property Physport int64Optional Link to this property

RoutedSubnets \[]RoutedSubnetOptional

NextHop string A valid IPv4 address. Link to this property Prefix string A valid CIDR notation representing an IP range. Link to this property Nat NatOptional Link to this property

Link to this property SiteID stringOptional Identifier maxLength32 Link to this property StaticAddressing LANStaticAddressingOptional 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 VlanTag int64Optional 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)>)

type LANStaticAddressing struct{…} 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 DHCPRelay DHCPRelayOptional Link to this property DHCPServer DHCPServerOptional Link to this property SecondaryAddress stringOptional A valid CIDR notation representing an IP range. Link to this property VirtualAddress stringOptional 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)>)

type Nat struct{…}

StaticPrefix stringOptional 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)>)

type RoutedSubnet struct{…}

NextHop string A valid IPv4 address. Link to this property Prefix string A valid CIDR notation representing an IP range. Link to this property Nat NatOptional Link to this property

[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/go/resources/magic_transit/subresources/sites/subresources/wans/methods/list) client.MagicTransit.Sites.WANs.List(ctx, siteID, query) (\*SinglePage\[[WAN]()], error) GET/accounts/{account\_id}/magic/sites/{site\_id}/wans ##### [Site WAN Details](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/wans/methods/get) client.MagicTransit.Sites.WANs.Get(ctx, siteID, wanID, query) (\*[WAN](), error) GET/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Create a new Site WAN](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/wans/methods/create) client.MagicTransit.Sites.WANs.New(ctx, siteID, params) (\*SinglePage\[[WAN]()], error) POST/accounts/{account\_id}/magic/sites/{site\_id}/wans ##### [Update Site WAN](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/wans/methods/update) client.MagicTransit.Sites.WANs.Update(ctx, siteID, wanID, params) (\*[WAN](), error) PUT/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Patch Site WAN](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/wans/methods/edit) client.MagicTransit.Sites.WANs.Edit(ctx, siteID, wanID, params) (\*[WAN](), error) PATCH/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Delete Site WAN](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/sites/subresources/wans/methods/delete) client.MagicTransit.Sites.WANs.Delete(ctx, siteID, wanID, body) (\*[WAN](), error) DELETE/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### ModelsExpand Collapse

type WAN struct{…}

ID stringOptional Identifier maxLength32 Link to this property

HealthCheckRate WANHealthCheckRateOptional Magic WAN health check rate for tunnels created on this link. The default value is mid.

One of the following: const WANHealthCheckRateLow WANHealthCheckRate = "low" Link to this property const WANHealthCheckRateMid WANHealthCheckRate = "mid" Link to this property const WANHealthCheckRateHigh WANHealthCheckRate = "high" Link to this property

Link to this property LoadBalanceInnerFlows boolOptional Link to this property Name stringOptional Link to this property Physport int64Optional Link to this property Priority int64Optional Priority of WAN for traffic loadbalancing. Link to this property SiteID stringOptional Identifier maxLength32 Link to this property StaticAddressing WANStaticAddressingOptional (optional) if omitted, use DHCP. Submit secondary\_address when site is in high availability mode. Link to this property VlanTag int64Optional 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)>)

type WANStaticAddressing struct{…} (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 GatewayAddress string A valid IPv4 address. Link to this property SecondaryAddress stringOptional 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)>)