v8

latestOpenAPI 3.0.0raw.githubusercontent.com2026-01-23241216351.5 KB

Endpoints

Get

Get the status of an endpoint by ID

get/endpoints/{id}

Path parameters

idstring required

a resource identifier

Headers

ngrok-versioninteger required

Response

Get the status of an endpoint by ID

idstring

unique endpoint resource identifier

regionstring

identifier of the region this endpoint belongs to

created_atstring

timestamp when the endpoint was created in RFC 3339 format

updated_atstring

timestamp when the endpoint was updated in RFC 3339 format

public_urlstring

deprecated [replaced by URL]: URL of the hostport served by this endpoint

protostring

protocol served by this endpoint. one of http, https, tcp, or tls

schemestring

n/a

hostportstring

hostport served by this endpoint (hostname:port) -> soon to be deprecated

hoststring

n/a

portinteger

n/a

typestring

whether the endpoint is ephemeral (served directly by an agent-initiated tunnel) or edge (served by an edge) or cloud (represents a cloud endpoint)

metadatastring

user-supplied metadata of the associated tunnel or edge object

descriptionstring

user-supplied description of the associated tunnel

upstream_urlstring

the local address the tunnel forwards to

upstream_protocolstring

the protocol the agent uses to forward with

urlstring

the url of the endpoint

traffic_policystring

The traffic policy attached to this endpoint

bindingsstring[]

the bindings associated with this endpoint

uristring

URI of the Cloud Endpoint API resource

namestring

user supplied name for the endpoint

pooling_enabledboolean

whether the endpoint allows pooling