--- title: CNIs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Network Interconnects](https://developers.cloudflare.com/api/python/resources/network_interconnects) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # CNIs ##### [List existing CNI objects](https://developers.cloudflare.com/api/python/resources/network_interconnects/subresources/cnis/methods/list) network\_interconnects.cnis.list(CNIListParams\*\*kwargs) -> [CNIListResponse]() GET/accounts/{account\_id}/cni/cnis ##### [Get information about a CNI object](https://developers.cloudflare.com/api/python/resources/network_interconnects/subresources/cnis/methods/get) network\_interconnects.cnis.get(strcni, CNIGetParams\*\*kwargs) -> [CNIGetResponse]() GET/accounts/{account\_id}/cni/cnis/{cni} ##### [Create a new CNI object](https://developers.cloudflare.com/api/python/resources/network_interconnects/subresources/cnis/methods/create) network\_interconnects.cnis.create(CNICreateParams\*\*kwargs) -> [CNICreateResponse]() POST/accounts/{account\_id}/cni/cnis ##### [Modify stored information about a CNI object](https://developers.cloudflare.com/api/python/resources/network_interconnects/subresources/cnis/methods/update) network\_interconnects.cnis.update(strcni, CNIUpdateParams\*\*kwargs) -> [CNIUpdateResponse]() PUT/accounts/{account\_id}/cni/cnis/{cni} ##### [Delete a specified CNI object](https://developers.cloudflare.com/api/python/resources/network_interconnects/subresources/cnis/methods/delete) network\_interconnects.cnis.delete(strcni, CNIDeleteParams\*\*kwargs) DELETE/accounts/{account\_id}/cni/cnis/{cni} ##### ModelsExpand Collapse
class CNIListResponse: …
items: List\[Item] id: str formatuuid Link to this property account: str Customer account tag Link to this property cust\_ip: str Customer end of the point-to-point link This should always be inside the same prefix as p2p_ip. formatA.B.C.D/N Link to this property interconnect: str Interconnect identifier hosting this CNI Link to this property
magic: ItemMagic conduit\_name: str Link to this property description: str Link to this property mtu: int formatint32 minimum0 Link to this property
Link to this property p2p\_ip: str Cloudflare end of the point-to-point link formatA.B.C.D/N Link to this property
bgp: Optional\[ItemBGP] customer\_asn: int ASN used on the customer end of the BGP session formatint32 minimum0 Link to this property extra\_prefixes: List\[str] Extra set of static prefixes to advertise to the customer’s end of the session Link to this property md5\_key: Optional\[str] MD5 key to use for session authentication. Note that *this is not a security measure*. MD5 is not a valid security mechanism, and the key is not treated as a secret value. This is *only* supported for preventing misconfiguration, not for defending against malicious attacks. The MD5 key, if set, must be of non-zero length and consist only of the following types of character: - ASCII alphanumerics: [a-zA-Z0-9] - Special characters in the set '!@#$%^&*()+[]{}<>/.,;:_-~= |\` In other words, MD5 keys may contain any printable ASCII character aside from newline (0x0A), quotation mark ("), vertical tab (0x0B), carriage return (0x0D), tab (0x09), form feed (0x0C), and the question mark (?). Requests specifying an MD5 key with one or more of these disallowed characters will be rejected. Link to this property
Link to this property
bgp\_mode: Optional\[Literal\["dynamic\_route\_exchange", "advertise\_only"]] The BGP mode for a CNI. One of the following: - dynamic_route_exchange - advertise_only One of the following: "dynamic\_route\_exchange" Link to this property "advertise\_only" Link to this property
Link to this property
Link to this property next: Optional\[int] formatint32 Link to this property
[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_list_response%20%3E%20(schema)>)
class CNIGetResponse: … id: str formatuuid Link to this property account: str Customer account tag Link to this property cust\_ip: str Customer end of the point-to-point link This should always be inside the same prefix as p2p_ip. formatA.B.C.D/N Link to this property interconnect: str Interconnect identifier hosting this CNI Link to this property
magic: Magic conduit\_name: str Link to this property description: str Link to this property mtu: int formatint32 minimum0 Link to this property
Link to this property p2p\_ip: str Cloudflare end of the point-to-point link formatA.B.C.D/N Link to this property
bgp: Optional\[BGP] customer\_asn: int ASN used on the customer end of the BGP session formatint32 minimum0 Link to this property extra\_prefixes: List\[str] Extra set of static prefixes to advertise to the customer’s end of the session Link to this property md5\_key: Optional\[str] MD5 key to use for session authentication. Note that *this is not a security measure*. MD5 is not a valid security mechanism, and the key is not treated as a secret value. This is *only* supported for preventing misconfiguration, not for defending against malicious attacks. The MD5 key, if set, must be of non-zero length and consist only of the following types of character: - ASCII alphanumerics: [a-zA-Z0-9] - Special characters in the set '!@#$%^&*()+[]{}<>/.,;:_-~= |\` In other words, MD5 keys may contain any printable ASCII character aside from newline (0x0A), quotation mark ("), vertical tab (0x0B), carriage return (0x0D), tab (0x09), form feed (0x0C), and the question mark (?). Requests specifying an MD5 key with one or more of these disallowed characters will be rejected. Link to this property
Link to this property
bgp\_mode: Optional\[Literal\["dynamic\_route\_exchange", "advertise\_only"]] The BGP mode for a CNI. One of the following: - dynamic_route_exchange - advertise_only One of the following: "dynamic\_route\_exchange" Link to this property "advertise\_only" Link to this property
Link to this property
[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_get_response%20%3E%20(schema)>)
class CNICreateResponse: … id: str formatuuid Link to this property account: str Customer account tag Link to this property cust\_ip: str Customer end of the point-to-point link This should always be inside the same prefix as p2p_ip. formatA.B.C.D/N Link to this property interconnect: str Interconnect identifier hosting this CNI Link to this property
magic: Magic conduit\_name: str Link to this property description: str Link to this property mtu: int formatint32 minimum0 Link to this property
Link to this property p2p\_ip: str Cloudflare end of the point-to-point link formatA.B.C.D/N Link to this property
bgp: Optional\[BGP] customer\_asn: int ASN used on the customer end of the BGP session formatint32 minimum0 Link to this property extra\_prefixes: List\[str] Extra set of static prefixes to advertise to the customer’s end of the session Link to this property md5\_key: Optional\[str] MD5 key to use for session authentication. Note that *this is not a security measure*. MD5 is not a valid security mechanism, and the key is not treated as a secret value. This is *only* supported for preventing misconfiguration, not for defending against malicious attacks. The MD5 key, if set, must be of non-zero length and consist only of the following types of character: - ASCII alphanumerics: [a-zA-Z0-9] - Special characters in the set '!@#$%^&*()+[]{}<>/.,;:_-~= |\` In other words, MD5 keys may contain any printable ASCII character aside from newline (0x0A), quotation mark ("), vertical tab (0x0B), carriage return (0x0D), tab (0x09), form feed (0x0C), and the question mark (?). Requests specifying an MD5 key with one or more of these disallowed characters will be rejected. Link to this property
Link to this property
bgp\_mode: Optional\[Literal\["dynamic\_route\_exchange", "advertise\_only"]] The BGP mode for a CNI. One of the following: - dynamic_route_exchange - advertise_only One of the following: "dynamic\_route\_exchange" Link to this property "advertise\_only" Link to this property
Link to this property
[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)>)
class CNIUpdateResponse: … id: str formatuuid Link to this property account: str Customer account tag Link to this property cust\_ip: str Customer end of the point-to-point link This should always be inside the same prefix as p2p_ip. formatA.B.C.D/N Link to this property interconnect: str Interconnect identifier hosting this CNI Link to this property
magic: Magic conduit\_name: str Link to this property description: str Link to this property mtu: int formatint32 minimum0 Link to this property
Link to this property p2p\_ip: str Cloudflare end of the point-to-point link formatA.B.C.D/N Link to this property
bgp: Optional\[BGP] customer\_asn: int ASN used on the customer end of the BGP session formatint32 minimum0 Link to this property extra\_prefixes: List\[str] Extra set of static prefixes to advertise to the customer’s end of the session Link to this property md5\_key: Optional\[str] MD5 key to use for session authentication. Note that *this is not a security measure*. MD5 is not a valid security mechanism, and the key is not treated as a secret value. This is *only* supported for preventing misconfiguration, not for defending against malicious attacks. The MD5 key, if set, must be of non-zero length and consist only of the following types of character: - ASCII alphanumerics: [a-zA-Z0-9] - Special characters in the set '!@#$%^&*()+[]{}<>/.,;:_-~= |\` In other words, MD5 keys may contain any printable ASCII character aside from newline (0x0A), quotation mark ("), vertical tab (0x0B), carriage return (0x0D), tab (0x09), form feed (0x0C), and the question mark (?). Requests specifying an MD5 key with one or more of these disallowed characters will be rejected. Link to this property
Link to this property
bgp\_mode: Optional\[Literal\["dynamic\_route\_exchange", "advertise\_only"]] The BGP mode for a CNI. One of the following: - dynamic_route_exchange - advertise_only One of the following: "dynamic\_route\_exchange" Link to this property "advertise\_only" Link to this property
Link to this property
[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_update_response%20%3E%20(schema)>)