---
title: Tunnels
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

[Zero Trust](https://developers.cloudflare.com/api/go/resources/zero_trust)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Tunnels

##### [List All Tunnels](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/methods/list)

client.ZeroTrust.Tunnels.List(ctx, params) (\*V4PagePaginationArray\[[TunnelListResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels%20%3E%20(model)%20TunnelListResponse%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/tunnels

#### TunnelsCloudflared

##### [List Cloudflare Tunnels](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/methods/list)

client.ZeroTrust.Tunnels.Cloudflared.List(ctx, params) (\*V4PagePaginationArray\[[CloudflareTunnel](<https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20cloudflare_tunnel%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/cfd\_tunnel

##### [Get a Cloudflare Tunnel](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/methods/get)

client.ZeroTrust.Tunnels.Cloudflared.Get(ctx, tunnelID, query) (\*[CloudflareTunnel](<https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20cloudflare_tunnel%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}

##### [Create a Cloudflare Tunnel](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/methods/create)

client.ZeroTrust.Tunnels.Cloudflared.New(ctx, params) (\*[CloudflareTunnel](<https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20cloudflare_tunnel%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/cfd\_tunnel

##### [Update a Cloudflare Tunnel](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/methods/edit)

client.ZeroTrust.Tunnels.Cloudflared.Edit(ctx, tunnelID, params) (\*[CloudflareTunnel](<https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20cloudflare_tunnel%20%3E%20(schema)>), error)

PATCH/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}

##### [Delete a Cloudflare Tunnel](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/methods/delete)

client.ZeroTrust.Tunnels.Cloudflared.Delete(ctx, tunnelID, body) (\*[CloudflareTunnel](<https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20cloudflare_tunnel%20%3E%20(schema)>), error)

DELETE/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}

#### TunnelsCloudflaredConfigurations

##### [Get Tunnel configuration](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/subresources/configurations/methods/get)

client.ZeroTrust.Tunnels.Cloudflared.Configurations.Get(ctx, tunnelID, query) (\*[TunnelCloudflaredConfigurationGetResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.cloudflared.configurations%20%3E%20(model)%20TunnelCloudflaredConfigurationGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}/configurations

##### [Update Tunnel configuration](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/subresources/configurations/methods/update)

client.ZeroTrust.Tunnels.Cloudflared.Configurations.Update(ctx, tunnelID, params) (\*[TunnelCloudflaredConfigurationUpdateResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.cloudflared.configurations%20%3E%20(model)%20TunnelCloudflaredConfigurationUpdateResponse%20%3E%20(schema)>), error)

PUT/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}/configurations

#### TunnelsCloudflaredConnections

##### [List Cloudflare Tunnel connections](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/subresources/connections/methods/get)

client.ZeroTrust.Tunnels.Cloudflared.Connections.Get(ctx, tunnelID, query) (\*SinglePage\[[Client](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}/connections

##### [Clean up Cloudflare Tunnel connections](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/subresources/connections/methods/delete)

client.ZeroTrust.Tunnels.Cloudflared.Connections.Delete(ctx, tunnelID, params) (\*[TunnelCloudflaredConnectionDeleteResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20TunnelCloudflaredConnectionDeleteResponse%20%3E%20(schema)>), error)

DELETE/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}/connections

##### ModelsExpand Collapse

<details>

<summary>

type Client struct{…}

A client (typically cloudflared) that maintains connections to a Cloudflare data center.

</summary>

ID stringOptional

UUID of the Cloudflare Tunnel connection.

formatuuid

maxLength36

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

Arch stringOptional

The cloudflared OS architecture used to establish this connection.

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20arch">Link to this property</a>

ConfigVersion int64Optional

The version of the remote tunnel configuration. Used internally to sync cloudflared with the Zero Trust dashboard.

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20config_version">Link to this property</a>

<details>

<summary>

Conns \[]ClientConnOptional

The Cloudflare Tunnel connections between your origin and Cloudflare’s edge.

</summary>

ID stringOptional

UUID of the Cloudflare Tunnel connection.

formatuuid

maxLength36

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns%20%3E%20(items)%20%3E%20(property)%20id">Link to this property</a>

ClientID stringOptional

UUID of the Cloudflare Tunnel connector.

formatuuid

maxLength36

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns%20%3E%20(items)%20%3E%20(property)%20client_id">Link to this property</a>

ClientVersion stringOptional

The cloudflared version used to establish this connection.

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns%20%3E%20(items)%20%3E%20(property)%20client_version">Link to this property</a>

ColoName stringOptional

The Cloudflare data center used for this connection.

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns%20%3E%20(items)%20%3E%20(property)%20colo_name">Link to this property</a>

DeprecatedIsPendingReconnect boolOptional

This functionality has been removed. The is\_pending\_reconnect field will now always report false.

Cloudflare continues to track connections for several minutes after they disconnect. This is an optimization to improve latency and reliability of reconnecting. If <code>true</code>, the connection has disconnected but is still being tracked. If <code>false</code>, the connection is actively serving traffic.

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns%20%3E%20(items)%20%3E%20(property)%20is_pending_reconnect">Link to this property</a>

OpenedAt TimeOptional

Timestamp of when the connection was established.

formatdate-time

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns%20%3E%20(items)%20%3E%20(property)%20opened_at">Link to this property</a>

OriginIP stringOptional

The public IP address of the host running cloudflared.

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns%20%3E%20(items)%20%3E%20(property)%20origin_ip">Link to this property</a>

UUID stringOptional

UUID of the Cloudflare Tunnel connection.

formatuuid

maxLength36

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns%20%3E%20(items)%20%3E%20(property)%20uuid">Link to this property</a>

</details>

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20conns">Link to this property</a>

Features \[]stringOptional

Features enabled for the Cloudflare Tunnel.

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20features">Link to this property</a>

RunAt TimeOptional

Timestamp of when the tunnel connection was started.

formatdate-time

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20run_at">Link to this property</a>

Version stringOptional

The cloudflared version used to establish this connection.

<a href="#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)%20%3E%20(property)%20version">Link to this property</a>

</details>

[Link to this property](<#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)>)

#### TunnelsCloudflaredToken

##### [Get a Cloudflare Tunnel token](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/subresources/token/methods/get)

client.ZeroTrust.Tunnels.Cloudflared.Token.Get(ctx, tunnelID, query) (\*string, error)

GET/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}/token

#### TunnelsCloudflaredConnectors

##### [Get Cloudflare Tunnel connector](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/subresources/connectors/methods/get)

client.ZeroTrust.Tunnels.Cloudflared.Connectors.Get(ctx, tunnelID, connectorID, query) (\*[Client](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.cloudflared.connections%20%3E%20(model)%20client%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}/connectors/{connector\_id}

#### TunnelsCloudflaredManagement

##### [Get a Cloudflare Tunnel management token](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/cloudflared/subresources/management/methods/create)

client.ZeroTrust.Tunnels.Cloudflared.Management.New(ctx, tunnelID, params) (\*string, error)

POST/accounts/{account\_id}/cfd\_tunnel/{tunnel\_id}/management

#### TunnelsWARP Connector

##### [List Mesh nodes](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/methods/list)

client.ZeroTrust.Tunnels.WARPConnector.List(ctx, params) (\*V4PagePaginationArray\[[TunnelWARPConnectorListResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector%20%3E%20(model)%20TunnelWARPConnectorListResponse%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/warp\_connector

##### [Get a Mesh node](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/methods/get)

client.ZeroTrust.Tunnels.WARPConnector.Get(ctx, tunnelID, query) (\*[TunnelWARPConnectorGetResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector%20%3E%20(model)%20TunnelWARPConnectorGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/warp\_connector/{tunnel\_id}

##### [Create a Mesh node](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/methods/create)

client.ZeroTrust.Tunnels.WARPConnector.New(ctx, params) (\*[TunnelWARPConnectorNewResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector%20%3E%20(model)%20TunnelWARPConnectorNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/warp\_connector

##### [Update a Mesh node](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/methods/edit)

client.ZeroTrust.Tunnels.WARPConnector.Edit(ctx, tunnelID, params) (\*[TunnelWARPConnectorEditResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector%20%3E%20(model)%20TunnelWARPConnectorEditResponse%20%3E%20(schema)>), error)

PATCH/accounts/{account\_id}/warp\_connector/{tunnel\_id}

##### [Delete a Mesh node](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/methods/delete)

client.ZeroTrust.Tunnels.WARPConnector.Delete(ctx, tunnelID, body) (\*[TunnelWARPConnectorDeleteResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector%20%3E%20(model)%20TunnelWARPConnectorDeleteResponse%20%3E%20(schema)>), error)

DELETE/accounts/{account\_id}/warp\_connector/{tunnel\_id}

#### TunnelsWARP ConnectorToken

##### [Get a Mesh node token](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/subresources/token/methods/get)

client.ZeroTrust.Tunnels.WARPConnector.Token.Get(ctx, tunnelID, query) (\*string, error)

GET/accounts/{account\_id}/warp\_connector/{tunnel\_id}/token

#### TunnelsWARP ConnectorConnections

##### [List Mesh node connections](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/subresources/connections/methods/get)

client.ZeroTrust.Tunnels.WARPConnector.Connections.Get(ctx, tunnelID, query) (\*SinglePage\[[TunnelWARPConnectorConnectionGetResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector.connections%20%3E%20(model)%20TunnelWARPConnectorConnectionGetResponse%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/warp\_connector/{tunnel\_id}/connections

#### TunnelsWARP ConnectorConnectors

##### [Get a Mesh node connector](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/subresources/connectors/methods/get)

client.ZeroTrust.Tunnels.WARPConnector.Connectors.Get(ctx, tunnelID, connectorID, query) (\*[TunnelWARPConnectorConnectorGetResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector.connectors%20%3E%20(model)%20TunnelWARPConnectorConnectorGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/warp\_connector/{tunnel\_id}/connectors/{connector\_id}

#### TunnelsWARP ConnectorFailover

##### [Trigger a manual failover for a Mesh node](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/subresources/failover/methods/update)

client.ZeroTrust.Tunnels.WARPConnector.Failover.Update(ctx, tunnelID, params) (\*[TunnelWARPConnectorFailoverUpdateResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector.failover%20%3E%20(model)%20TunnelWARPConnectorFailoverUpdateResponse%20%3E%20(schema)>), error)

PUT/accounts/{account\_id}/warp\_connector/{tunnel\_id}/failover

#### TunnelsWARP ConnectorConfigurations

##### [Get Mesh node HA configuration](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/subresources/configurations/methods/get)

client.ZeroTrust.Tunnels.WARPConnector.Configurations.Get(ctx, tunnelID, query) (\*[TunnelWARPConnectorConfigurationGetResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector.configurations%20%3E%20(model)%20TunnelWARPConnectorConfigurationGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/warp\_connector/{tunnel\_id}/configurations

##### [Update Mesh node HA configuration](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/tunnels/subresources/warp_connector/subresources/configurations/methods/update)

client.ZeroTrust.Tunnels.WARPConnector.Configurations.Update(ctx, tunnelID, params) (\*[TunnelWARPConnectorConfigurationUpdateResponse](<https://developers.cloudflare.com/api/go/resources/zero_trust#(resource)%20zero_trust.tunnels.warp_connector.configurations%20%3E%20(model)%20TunnelWARPConnectorConfigurationUpdateResponse%20%3E%20(schema)>), error)

PUT/accounts/{account\_id}/warp\_connector/{tunnel\_id}/configurations