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."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/tunnel"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.