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. |
JSON Schema
{
"$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."
}
}
}