Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ngrok Backends API

Backends define how traffic is handled, including tunnel group, weighted, failover, HTTP response, and static address backends.

ngrok Backends API is one of 24 APIs that ngrok publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 12 JSON Schema definitions.

Tagged areas include Backends. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a JSON-LD context, a GitHub repository, and 12 JSON Schemas.

This API exposes 25 operations across 10 paths, and defines 11 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://api.ngrok.com.

25 operations 10 paths 11 schemas 5 DELETE10 GET5 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://api.ngrok.com
Authentication
HTTP Bearer, API Key
Contact
Resource Areas
1

Authentication & Security 2

ngrok Backends API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). An API key is passed in the header as Authorization (apiKeyAuth). By default, every request must be authenticated.

  • bearerAuth — Use an ngrok API key as a Bearer token. Create API keys from the ngrok dashboard or via the API Keys endpoints.
  • apiKeyAuth — Pass the API key in the Authorization header prefixed with 'Bearer '.

Paths & Operations 25

Across 10 paths, the API surfaces 25 operations — 5 DELETE, 10 GET, 5 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Backends 25

Backends define how traffic is handled, including tunnel group, weighted, failover, HTTP response, and static address backends.

POST
/backends/tunnel_group
Ngrok Create Tunnel Group Backend
createTunnelGroupBackend body → 201
GET
/backends/tunnel_group
Ngrok List Tunnel Group Backends
listTunnelGroupBackends 2 params → 200
GET
/backends/tunnel_group/{id}
Ngrok Get Tunnel Group Backend
getTunnelGroupBackend 1 param → 200
PATCH
/backends/tunnel_group/{id}
Ngrok Update Tunnel Group Backend
updateTunnelGroupBackend 1 param body → 200
DELETE
/backends/tunnel_group/{id}
Ngrok Delete Tunnel Group Backend
deleteTunnelGroupBackend 1 param → 204
POST
/backends/weighted
Ngrok Create Weighted Backend
createWeightedBackend body → 201
GET
/backends/weighted
Ngrok List Weighted Backends
listWeightedBackends 2 params → 200
GET
/backends/weighted/{id}
Ngrok Get Weighted Backend
getWeightedBackend 1 param → 200
PATCH
/backends/weighted/{id}
Ngrok Update Weighted Backend
updateWeightedBackend 1 param body → 200
DELETE
/backends/weighted/{id}
Ngrok Delete Weighted Backend
deleteWeightedBackend 1 param → 204
POST
/backends/failover
Ngrok Create Failover Backend
createFailoverBackend body → 201
GET
/backends/failover
Ngrok List Failover Backends
listFailoverBackends 2 params → 200
GET
/backends/failover/{id}
Ngrok Get Failover Backend
getFailoverBackend 1 param → 200
PATCH
/backends/failover/{id}
Ngrok Update Failover Backend
updateFailoverBackend 1 param body → 200
DELETE
/backends/failover/{id}
Ngrok Delete Failover Backend
deleteFailoverBackend 1 param → 204
POST
/backends/http_response
Ngrok Create HTTP Response Backend
createHttpResponseBackend body → 201
GET
/backends/http_response
Ngrok List HTTP Response Backends
listHttpResponseBackends 2 params → 200
GET
/backends/http_response/{id}
Ngrok Get HTTP Response Backend
getHttpResponseBackend 1 param → 200
PATCH
/backends/http_response/{id}
Ngrok Update HTTP Response Backend
updateHttpResponseBackend 1 param body → 200
DELETE
/backends/http_response/{id}
Ngrok Delete HTTP Response Backend
deleteHttpResponseBackend 1 param → 204
POST
/backends/static_address
Ngrok Create Static Address Backend
createStaticAddressBackend body → 201
GET
/backends/static_address
Ngrok List Static Address Backends
listStaticAddressBackends 2 params → 200
GET
/backends/static_address/{id}
Ngrok Get Static Address Backend
getStaticAddressBackend 1 param → 200
PATCH
/backends/static_address/{id}
Ngrok Update Static Address Backend
updateStaticAddressBackend 1 param body → 200
DELETE
/backends/static_address/{id}
Ngrok Delete Static Address Backend
deleteStaticAddressBackend 1 param → 204

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are HttpResponseBackend (8 properties), TunnelGroupBackend (7 properties), StaticAddressBackend (7 properties), FailoverBackend (6 properties). Each schema is shown below with its type and property counts.

FailoverBackend
object
6 properties
StaticAddressBackendList
object
3 properties
HttpResponseBackendList
object
3 properties
TunnelGroupBackendList
object
3 properties
WeightedBackend
object
6 properties
HttpResponseBackend
object
8 properties
WeightedBackendList
object
3 properties
Ref
object
2 properties
FailoverBackendList
object
3 properties
TunnelGroupBackend
object
7 properties
StaticAddressBackend
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ngrok-backends-api-openapi.yml Raw ↑

Other APIs ngrok publishes across the network.

ngrok Abuse Reports API
ngrok Agent Ingresses API
ngrok API Keys API
ngrok Certificate Authorities API
ngrok Credentials API
ngrok Edges HTTPS API
ngrok Edges TCP API
ngrok Edges TLS API
ngrok Endpoints API
ngrok Event Destinations API
ngrok Event Subscriptions API
ngrok IP Policies API