ngrok · Schema

ngrok Tunnel

A Tunnel represents an individual tunnel connection within a tunnel session, exposing a local service via a public URL through the ngrok network.

AI GatewayAPI GatewayComputeDeveloper ToolsGatewaysIngressPlatformProxiesServersTunnels

Properties

Name Type Description
id string Unique identifier for the tunnel.
public_url string The public URL of the tunnel.
started_at string Timestamp when the tunnel was started.
metadata string Arbitrary user-defined metadata for the tunnel.
proto string The protocol of the tunnel (e.g., http, https, tcp, tls).
region string The ngrok region where the tunnel is running.
tunnel_session object Reference to the tunnel session that created this tunnel.
endpoint object Reference to the endpoint associated with this tunnel.
labels object Labels assigned to the tunnel for routing with labeled tunnels.
backends array References to the backends this tunnel is attached to.
forwards_to string The address that this tunnel forwards traffic to.
uri string URI of the tunnel API resource.
View JSON Schema on GitHub

JSON Schema

tunnel.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/api-evangelist/ngrok/blob/main/json-schema/tunnel.json",
  "title": "ngrok Tunnel",
  "description": "A Tunnel represents an individual tunnel connection within a tunnel session, exposing a local service via a public URL through the ngrok network.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the tunnel."
    },
    "public_url": {
      "type": "string",
      "description": "The public URL of the tunnel."
    },
    "started_at": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the tunnel was started."
    },
    "metadata": {
      "type": "string",
      "description": "Arbitrary user-defined metadata for the tunnel."
    },
    "proto": {
      "type": "string",
      "description": "The protocol of the tunnel (e.g., http, https, tcp, tls)."
    },
    "region": {
      "type": "string",
      "description": "The ngrok region where the tunnel is running."
    },
    "tunnel_session": {
      "type": "object",
      "description": "Reference to the tunnel session that created this tunnel.",
      "properties": {
        "id": {
          "type": "string"
        },
        "uri": {
          "type": "string"
        }
      }
    },
    "endpoint": {
      "type": "object",
      "description": "Reference to the endpoint associated with this tunnel.",
      "properties": {
        "id": {
          "type": "string"
        },
        "uri": {
          "type": "string"
        }
      }
    },
    "labels": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Labels assigned to the tunnel for routing with labeled tunnels."
    },
    "backends": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "uri": {
            "type": "string"
          }
        }
      },
      "description": "References to the backends this tunnel is attached to."
    },
    "forwards_to": {
      "type": "string",
      "description": "The address that this tunnel forwards traffic to."
    },
    "uri": {
      "type": "string",
      "description": "URI of the tunnel API resource."
    }
  }
}