--- title: Sites --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Magic Transit](https://developers.cloudflare.com/api/python/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/python/resources/magic_transit/subresources/sites/methods/list) magic\_transit.sites.list(SiteListParams\*\*kwargs) -> SyncSinglePage\[[Site]()] GET/accounts/{account\_id}/magic/sites ##### [Site Details](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/methods/get) magic\_transit.sites.get(strsite\_id, SiteGetParams\*\*kwargs) -> [Site]() GET/accounts/{account\_id}/magic/sites/{site\_id} ##### [Create a new Site](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/methods/create) magic\_transit.sites.create(SiteCreateParams\*\*kwargs) -> [Site]() POST/accounts/{account\_id}/magic/sites ##### [Update Site](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/methods/update) magic\_transit.sites.update(strsite\_id, SiteUpdateParams\*\*kwargs) -> [Site]() PUT/accounts/{account\_id}/magic/sites/{site\_id} ##### [Patch Site](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/methods/edit) magic\_transit.sites.edit(strsite\_id, SiteEditParams\*\*kwargs) -> [Site]() PATCH/accounts/{account\_id}/magic/sites/{site\_id} ##### [Delete Site](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/methods/delete) magic\_transit.sites.delete(strsite\_id, SiteDeleteParams\*\*kwargs) -> [Site]() DELETE/accounts/{account\_id}/magic/sites/{site\_id} ##### ModelsExpand Collapse
class Site: … id: Optional\[str] Identifier maxLength32 Link to this property connector\_id: Optional\[str] Magic Connector identifier tag. Link to this property description: Optional\[str] Link to this property ha\_mode: Optional\[bool] 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] Location of site in latitude and longitude. Link to this property name: Optional\[str] The name of the site. Link to this property secondary\_connector\_id: Optional\[str] 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)>)
class SiteLocation: … Location of site in latitude and longitude. lat: Optional\[str] Latitude Link to this property lon: Optional\[str] 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/python/resources/magic_transit/subresources/sites/subresources/acls/methods/list) magic\_transit.sites.acls.list(strsite\_id, ACLListParams\*\*kwargs) -> SyncSinglePage\[[ACL]()] GET/accounts/{account\_id}/magic/sites/{site\_id}/acls ##### [Site ACL Details](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/acls/methods/get) magic\_transit.sites.acls.get(stracl\_id, ACLGetParams\*\*kwargs) -> [ACL]() GET/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Create a new Site ACL](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/acls/methods/create) magic\_transit.sites.acls.create(strsite\_id, ACLCreateParams\*\*kwargs) -> [ACL]() POST/accounts/{account\_id}/magic/sites/{site\_id}/acls ##### [Update Site ACL](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/acls/methods/update) magic\_transit.sites.acls.update(stracl\_id, ACLUpdateParams\*\*kwargs) -> [ACL]() PUT/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Patch Site ACL](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/acls/methods/edit) magic\_transit.sites.acls.edit(stracl\_id, ACLEditParams\*\*kwargs) -> [ACL]() PATCH/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### [Delete Site ACL](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/acls/methods/delete) magic\_transit.sites.acls.delete(stracl\_id, ACLDeleteParams\*\*kwargs) -> [ACL]() DELETE/accounts/{account\_id}/magic/sites/{site\_id}/acls/{acl\_id} ##### ModelsExpand Collapse
class ACL: … Bidirectional ACL policy for network traffic within a site. id: Optional\[str] Identifier maxLength32 Link to this property description: Optional\[str] Description for the ACL. Link to this property forward\_locally: Optional\[bool] 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] Link to this property lan\_2: Optional\[ACLConfiguration] Link to this property name: Optional\[str] The name of the ACL. Link to this property
protocols: Optional\[List\[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\[bool] 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)>)
class ACLConfiguration: … lan\_id: str The identifier for the LAN you want to create an ACL policy with. Link to this property lan\_name: Optional\[str] The name of the LAN based on the provided lan\_id. Link to this property port\_ranges: Optional\[List\[str]] 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\[List\[int]] 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\[List\[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)>)
Literal\["tcp", "udp", "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)>) str 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/python/resources/magic_transit/subresources/sites/subresources/lans/methods/list) magic\_transit.sites.lans.list(strsite\_id, LANListParams\*\*kwargs) -> SyncSinglePage\[[LAN]()] GET/accounts/{account\_id}/magic/sites/{site\_id}/lans ##### [Site LAN Details](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/lans/methods/get) magic\_transit.sites.lans.get(strlan\_id, LANGetParams\*\*kwargs) -> [LAN]() GET/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Create a new Site LAN](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/lans/methods/create) magic\_transit.sites.lans.create(strsite\_id, LANCreateParams\*\*kwargs) -> SyncSinglePage\[[LAN]()] POST/accounts/{account\_id}/magic/sites/{site\_id}/lans ##### [Update Site LAN](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/lans/methods/update) magic\_transit.sites.lans.update(strlan\_id, LANUpdateParams\*\*kwargs) -> [LAN]() PUT/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Patch Site LAN](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/lans/methods/edit) magic\_transit.sites.lans.edit(strlan\_id, LANEditParams\*\*kwargs) -> [LAN]() PATCH/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### [Delete Site LAN](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/lans/methods/delete) magic\_transit.sites.lans.delete(strlan\_id, LANDeleteParams\*\*kwargs) -> [LAN]() DELETE/accounts/{account\_id}/magic/sites/{site\_id}/lans/{lan\_id} ##### ModelsExpand Collapse
class DHCPRelay: … server\_addresses: Optional\[List\[str]] 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)>)
class DHCPServer: …
dhcp\_options: Optional\[List\[DHCPOption]] Optional list of custom DHCP options to include in DHCP responses. Only valid when DHCP server is enabled. code: int 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: Literal\["text", "hex", "ip", 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: str The option value, interpreted according to the type field. Link to this property
Link to this property dhcp\_pool\_end: Optional\[str] A valid IPv4 address. Link to this property dhcp\_pool\_start: Optional\[str] A valid IPv4 address. Link to this property Deprecateddns\_server: Optional\[str] A valid IPv4 address. Link to this property dns\_servers: Optional\[List\[str]] Link to this property reservations: Optional\[Dict\[str, str]] 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)>)
class LAN: … id: Optional\[str] Identifier maxLength32 Link to this property bond\_id: Optional\[int] Link to this property ha\_link: Optional\[bool] 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\[bool] mark true to use this LAN for source-based breakout traffic Link to this property is\_prioritized: Optional\[bool] mark true to use this LAN for source-based prioritized traffic Link to this property name: Optional\[str] Link to this property nat: Optional\[Nat] Link to this property physport: Optional\[int] Link to this property
routed\_subnets: Optional\[List\[RoutedSubnet]] next\_hop: str A valid IPv4 address. Link to this property prefix: str A valid CIDR notation representing an IP range. Link to this property nat: Optional\[Nat] Link to this property
Link to this property site\_id: Optional\[str] Identifier maxLength32 Link to this property static\_addressing: Optional\[LANStaticAddressing] 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\[int] 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)>)
class LANStaticAddressing: … 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: str A valid CIDR notation representing an IP range. Link to this property dhcp\_relay: Optional\[DHCPRelay] Link to this property dhcp\_server: Optional\[DHCPServer] Link to this property secondary\_address: Optional\[str] A valid CIDR notation representing an IP range. Link to this property virtual\_address: Optional\[str] 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)>)
class Nat: … static\_prefix: Optional\[str] 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)>)
class RoutedSubnet: … next\_hop: str A valid IPv4 address. Link to this property prefix: str A valid CIDR notation representing an IP range. Link to this property nat: Optional\[Nat] 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/python/resources/magic_transit/subresources/sites/subresources/wans/methods/list) magic\_transit.sites.wans.list(strsite\_id, WANListParams\*\*kwargs) -> SyncSinglePage\[[WAN]()] GET/accounts/{account\_id}/magic/sites/{site\_id}/wans ##### [Site WAN Details](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/wans/methods/get) magic\_transit.sites.wans.get(strwan\_id, WANGetParams\*\*kwargs) -> [WAN]() GET/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Create a new Site WAN](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/wans/methods/create) magic\_transit.sites.wans.create(strsite\_id, WANCreateParams\*\*kwargs) -> SyncSinglePage\[[WAN]()] POST/accounts/{account\_id}/magic/sites/{site\_id}/wans ##### [Update Site WAN](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/wans/methods/update) magic\_transit.sites.wans.update(strwan\_id, WANUpdateParams\*\*kwargs) -> [WAN]() PUT/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Patch Site WAN](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/wans/methods/edit) magic\_transit.sites.wans.edit(strwan\_id, WANEditParams\*\*kwargs) -> [WAN]() PATCH/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### [Delete Site WAN](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites/subresources/wans/methods/delete) magic\_transit.sites.wans.delete(strwan\_id, WANDeleteParams\*\*kwargs) -> [WAN]() DELETE/accounts/{account\_id}/magic/sites/{site\_id}/wans/{wan\_id} ##### ModelsExpand Collapse
class WAN: … id: Optional\[str] Identifier maxLength32 Link to this property
health\_check\_rate: Optional\[Literal\["low", "mid", "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\[bool] Link to this property name: Optional\[str] Link to this property physport: Optional\[int] Link to this property priority: Optional\[int] Priority of WAN for traffic loadbalancing. Link to this property site\_id: Optional\[str] Identifier maxLength32 Link to this property static\_addressing: Optional\[WANStaticAddressing] (optional) if omitted, use DHCP. Submit secondary\_address when site is in high availability mode. Link to this property vlan\_tag: Optional\[int] 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)>)
class WANStaticAddressing: … (optional) if omitted, use DHCP. Submit secondary\_address when site is in high availability mode. address: str A valid CIDR notation representing an IP range. Link to this property gateway\_address: str A valid IPv4 address. Link to this property secondary\_address: Optional\[str] 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)>)