@ngrok/ngrok-api 0.2.0 → 0.8.0

package/lib/datatypes.d.ts

@@ -48,6 +48,47 @@ export interface AbuseReportCreate {
     /** arbitrary user-defined data about this abuse report. Optional, max 4096 bytes. */
     metadata: string;
 }
+export interface AgentIngressCreate {
+    /** human-readable description of the use of this Agent Ingress. optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this Agent Ingress. optional, max 4096 bytes */
+    metadata: string;
+    /** the domain that you own to be used as the base domain name to generate regional agent ingress domains. */
+    domain: string;
+}
+export interface AgentIngressUpdate {
+    id: string;
+    /** human-readable description of the use of this Agent Ingress. optional, max 255 bytes. */
+    description?: string;
+    /** arbitrary user-defined machine-readable data of this Agent Ingress. optional, max 4096 bytes */
+    metadata?: string;
+}
+export interface AgentIngress {
+    /** unique Agent Ingress resource identifier */
+    id: string;
+    /** URI to the API resource of this Agent ingress */
+    uri: string;
+    /** human-readable description of the use of this Agent Ingress. optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this Agent Ingress. optional, max 4096 bytes */
+    metadata: string;
+    /** the domain that you own to be used as the base domain name to generate regional agent ingress domains. */
+    domain: string;
+    /** a list of target values to use as the values of NS records for the domain property these values will delegate control over the domain to ngrok */
+    nsTargets: Array<string>;
+    /** a list of regional agent ingress domains that are subdomains of the value of domain this value may increase over time as ngrok adds more regions */
+    regionDomains: Array<string>;
+    /** timestamp when the Agent Ingress was created, RFC 3339 format */
+    createdAt: string;
+}
+export interface AgentIngressList {
+    /** the list of Agent Ingresses owned by this account */
+    ingresses: Array<AgentIngress>;
+    /** URI of the Agent Ingress list API resource */
+    uri: string;
+    /** URI of the next page, or null if there is no next page */
+    nextPageUri?: string;
+}
 export interface APIKeyCreate {
     /** human-readable description of what uses the API key to authenticate. optional, max 255 bytes. */
     description: string;
@@ -83,6 +124,172 @@ export interface APIKeyList {
     /** URI of the next page, or null if there is no next page */
     nextPageUri?: string;
 }
+export interface FailoverBackend {
+    /** unique identifier for this Failover backend */
+    id: string;
+    /** URI of the FailoverBackend API resource */
+    uri: string;
+    /** timestamp when the backend was created, RFC 3339 format */
+    createdAt: string;
+    /** human-readable description of this backend. Optional */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata: string;
+    /** the ids of the child backends in order */
+    backends: Array<string>;
+}
+export interface FailoverBackendCreate {
+    /** human-readable description of this backend. Optional */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata: string;
+    /** the ids of the child backends in order */
+    backends: Array<string>;
+}
+export interface FailoverBackendUpdate {
+    id: string;
+    /** human-readable description of this backend. Optional */
+    description?: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata?: string;
+    /** the ids of the child backends in order */
+    backends: Array<string>;
+}
+export interface FailoverBackendList {
+    /** the list of all Failover backends on this account */
+    backends: Array<FailoverBackend>;
+    /** URI of the Failover backends list API resource */
+    uri: string;
+    /** URI of the next page, or null if there is no next page */
+    nextPageUri?: string;
+}
+export interface HTTPResponseBackend {
+    id: string;
+    /** URI of the HTTPResponseBackend API resource */
+    uri: string;
+    /** timestamp when the backend was created, RFC 3339 format */
+    createdAt: string;
+    /** human-readable description of this backend. Optional */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata: string;
+    /** body to return as fixed content */
+    body: string;
+    /** headers to return */
+    headers: Map<string, string>;
+    /** status code to return */
+    statusCode: number;
+}
+export interface HTTPResponseBackendCreate {
+    /** human-readable description of this backend. Optional */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata: string;
+    /** body to return as fixed content */
+    body: string;
+    /** headers to return */
+    headers: Map<string, string>;
+    /** status code to return */
+    statusCode?: number;
+}
+export interface HTTPResponseBackendUpdate {
+    id: string;
+    /** human-readable description of this backend. Optional */
+    description?: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata?: string;
+    /** body to return as fixed content */
+    body?: string;
+    /** headers to return */
+    headers?: Map<string, string>;
+    /** status code to return */
+    statusCode?: number;
+}
+export interface HTTPResponseBackendList {
+    backends: Array<HTTPResponseBackend>;
+    uri: string;
+    nextPageUri?: string;
+}
+export interface TunnelGroupBackend {
+    /** unique identifier for this TunnelGroup backend */
+    id: string;
+    /** URI of the TunnelGroupBackend API resource */
+    uri: string;
+    /** timestamp when the backend was created, RFC 3339 format */
+    createdAt: string;
+    /** human-readable description of this backend. Optional */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata: string;
+    /** labels to watch for tunnels on, e.g. app->foo, dc->bar */
+    labels: Map<string, string>;
+    /** tunnels matching this backend */
+    tunnels: Array<Ref>;
+}
+export interface TunnelGroupBackendCreate {
+    /** human-readable description of this backend. Optional */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata: string;
+    /** labels to watch for tunnels on, e.g. app->foo, dc->bar */
+    labels: Map<string, string>;
+}
+export interface TunnelGroupBackendUpdate {
+    id: string;
+    /** human-readable description of this backend. Optional */
+    description?: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata?: string;
+    /** labels to watch for tunnels on, e.g. app->foo, dc->bar */
+    labels: Map<string, string>;
+}
+export interface TunnelGroupBackendList {
+    /** the list of all TunnelGroup backends on this account */
+    backends: Array<TunnelGroupBackend>;
+    /** URI of the TunnelGroup backends list API resource */
+    uri: string;
+    /** URI of the next page, or null if there is no next page */
+    nextPageUri?: string;
+}
+export interface WeightedBackend {
+    /** unique identifier for this Weighted backend */
+    id: string;
+    /** URI of the WeightedBackend API resource */
+    uri: string;
+    /** timestamp when the backend was created, RFC 3339 format */
+    createdAt: string;
+    /** human-readable description of this backend. Optional */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata: string;
+    /** the ids of the child backends to their weights (0-10000) */
+    backends: Map<string, number>;
+}
+export interface WeightedBackendCreate {
+    /** human-readable description of this backend. Optional */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata: string;
+    /** the ids of the child backends to their weights (0-10000) */
+    backends: Map<string, number>;
+}
+export interface WeightedBackendUpdate {
+    id: string;
+    /** human-readable description of this backend. Optional */
+    description?: string;
+    /** arbitrary user-defined machine-readable data of this backend. Optional */
+    metadata?: string;
+    /** the ids of the child backends to their weights (0-10000) */
+    backends: Map<string, number>;
+}
+export interface WeightedBackendList {
+    /** the list of all Weighted backends on this account */
+    backends: Array<WeightedBackend>;
+    /** URI of the Weighted backends list API resource */
+    uri: string;
+    /** URI of the next page, or null if there is no next page */
+    nextPageUri?: string;
+}
 export interface CertificateAuthorityCreate {
     /** human-readable description of this Certificate Authority. optional, max 255 bytes. */
     description: string;
@@ -171,120 +378,10 @@ export interface CredentialList {
     /** URI of the next page, or null if there is no next page */
     nextPageUri?: string;
 }
-export interface EndpointConfiguration {
-    /** unique identifier of this endpoint configuration */
-    id: string;
-    /** they type of traffic this endpoint configuration can be applied to. one of: `http`, `https`, `tcp` */
-    type: string;
-    /** human-readable description of what this endpoint configuration will be do when applied or what traffic it will be applied to. Optional, max 255 bytes */
-    description: string;
-    /** arbitrary user-defined machine-readable data of this endpoint configuration. Optional, max 4096 bytes. */
-    metadata: string;
-    /** timestamp when the endpoint configuration was created, RFC 3339 format */
-    createdAt: string;
-    /** URI of the endpoint configuration API resource */
-    uri: string;
-    /** circuit breaker module configuration or `null` */
-    circuitBreaker?: EndpointCircuitBreaker;
-    /** compression module configuration or `null` */
-    compression?: EndpointCompression;
-    /** request headers module configuration or `null` */
-    requestHeaders?: EndpointRequestHeaders;
-    /** response headers module configuration or `null` */
-    responseHeaders?: EndpointResponseHeaders;
-    /** ip policy module configuration or `null` */
-    ipPolicy?: EndpointIPPolicy;
-    /** mutual TLS module configuration or `null` */
-    mutualTls?: EndpointMutualTLS;
-    /** TLS termination module configuration or `null` */
-    tlsTermination?: EndpointTLSTermination;
-    /** webhook validation module configuration or `null` */
-    webhookValidation?: EndpointWebhookValidation;
-    /** oauth module configuration or `null` */
-    oauth?: EndpointOAuth;
-    /** logging module configuration or `null` */
-    logging?: EndpointLogging;
-    /** saml module configuration or `null` */
-    saml?: EndpointSAML;
-    /** oidc module configuration or `null` */
-    oidc?: EndpointOIDC;
-}
-export interface EndpointConfigurationList {
-    /** the list of all endpoint configurations on this account */
-    endpointConfigurations: Array<EndpointConfiguration>;
-    /** URI of the endpoint configurations list API resource */
-    uri: string;
-    /** URI of the next page, or null if there is no next page */
-    nextPageUri?: string;
-}
-export interface EndpointConfigurationUpdate {
-    /** unique identifier of this endpoint configuration */
-    id: string;
-    /** human-readable description of what this endpoint configuration will be do when applied or what traffic it will be applied to. Optional, max 255 bytes */
-    description?: string;
-    /** arbitrary user-defined machine-readable data of this endpoint configuration. Optional, max 4096 bytes. */
-    metadata?: string;
-    /** circuit breaker module configuration or `null` */
-    circuitBreaker?: EndpointCircuitBreaker;
-    /** compression module configuration or `null` */
-    compression?: EndpointCompression;
-    /** request headers module configuration or `null` */
-    requestHeaders?: EndpointRequestHeaders;
-    /** response headers module configuration or `null` */
-    responseHeaders?: EndpointResponseHeaders;
-    /** ip policy module configuration or `null` */
-    ipPolicy?: EndpointIPPolicyMutate;
-    /** mutual TLS module configuration or `null` */
-    mutualTls?: EndpointMutualTLSMutate;
-    /** TLS termination module configuration or `null` */
-    tlsTermination?: EndpointTLSTermination;
-    /** webhook validation module configuration or `null` */
-    webhookValidation?: EndpointWebhookValidation;
-    /** oauth module configuration or `null` */
-    oauth?: EndpointOAuth;
-    /** logging module configuration or `null` */
-    logging?: EndpointLoggingMutate;
-    /** saml module configuration or `null` */
-    saml?: EndpointSAMLMutate;
-    /** oidc module configuration or `null` */
-    oidc?: EndpointOIDC;
-}
-export interface EndpointConfigurationCreate {
-    /** they type of traffic this endpoint configuration can be applied to. one of: `http`, `https`, `tcp` */
-    type: string;
-    /** human-readable description of what this endpoint configuration will be do when applied or what traffic it will be applied to. Optional, max 255 bytes */
-    description: string;
-    /** arbitrary user-defined machine-readable data of this endpoint configuration. Optional, max 4096 bytes. */
-    metadata: string;
-    /** circuit breaker module configuration or `null` */
-    circuitBreaker?: EndpointCircuitBreaker;
-    /** compression module configuration or `null` */
-    compression?: EndpointCompression;
-    /** request headers module configuration or `null` */
-    requestHeaders?: EndpointRequestHeaders;
-    /** response headers module configuration or `null` */
-    responseHeaders?: EndpointResponseHeaders;
-    /** ip policy module configuration or `null` */
-    ipPolicy?: EndpointIPPolicyMutate;
-    /** mutual TLS module configuration or `null` */
-    mutualTls?: EndpointMutualTLSMutate;
-    /** TLS termination module configuration or `null` */
-    tlsTermination?: EndpointTLSTermination;
-    /** webhook validation module configuration or `null` */
-    webhookValidation?: EndpointWebhookValidation;
-    /** oauth module configuration or `null` */
-    oauth?: EndpointOAuth;
-    /** logging module configuration or `null` */
-    logging?: EndpointLoggingMutate;
-    /** saml module configuration or `null` */
-    saml?: EndpointSAMLMutate;
-    /** oidc module configuration or `null` */
-    oidc?: EndpointOIDC;
-}
 export interface EndpointWebhookValidation {
     /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
     enabled?: boolean;
-    /** a string indicating which webhook provider will be sending webhooks to this endpoint. Value must be one of the supported providers: `SLACK`, `SNS`, `STRIPE`, `GITHUB`, `TWILIO`, `SHOPIFY`, `GITLAB`, `INTERCOM`. */
+    /** a string indicating which webhook provider will be sending webhooks to this endpoint. Value must be one of the supported providers: `SLACK`, `SNS`, `STRIPE`, `GITHUB`, `TWILIO`, `SHOPIFY`, `GITLAB`, `INTERCOM`, `SENDGRID`, `XERO`, `PAGERDUTY`. */
     provider: string;
     /** a string secret used to validate requests from the given provider. All providers except AWS SNS require a secret */
     secret: string;
@@ -313,17 +410,11 @@ export interface EndpointTLSTermination {
     /** The minimum TLS version used for termination and advertised to the client during the TLS handshake. if unspecified, ngrok will choose an industry-safe default. This value must be null if `terminate_at` is set to `upstream`. */
     minVersion?: string;
 }
-export interface EndpointLogging {
-    /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
-    enabled?: boolean;
-    /** list of all EventStreams that will be used to configure and export this endpoint's logs */
-    eventStreams: Array<Ref>;
-}
-export interface EndpointLoggingMutate {
+export interface EndpointTLSTerminationAtEdge {
     /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
     enabled?: boolean;
-    /** list of all EventStreams that will be used to configure and export this endpoint's logs */
-    eventStreamIds: Array<string>;
+    /** The minimum TLS version used for termination and advertised to the client during the TLS handshake. if unspecified, ngrok will choose an industry-safe default. This value must be null if `terminate_at` is set to `upstream`. */
+    minVersion?: string;
 }
 export interface EndpointRequestHeaders {
     /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
@@ -473,6 +564,8 @@ export interface EndpointSAML {
     requestSigningCertificatePem: string;
     /** A public URL where the SP's metadata is hosted. If an IdP supports dynamic configuration, this is the URL it can use to retrieve the SP metadata. */
     metadataUrl: string;
+    /** Defines the name identifier format the SP expects the IdP to use in its assertions to identify subjects. If unspecified, a default value of `urn:oasis:names:tc:SAML:2.0:nameid-format:persistent` will be used. A subset of the allowed values enumerated by the SAML specification are supported. */
+    nameidFormat: string;
 }
 export interface EndpointSAMLMutate {
     /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
@@ -493,6 +586,8 @@ export interface EndpointSAMLMutate {
     allowIdpInitiated?: boolean;
     /** If present, only users who are a member of one of the listed groups may access the target endpoint. */
     authorizedGroups: Array<string>;
+    /** Defines the name identifier format the SP expects the IdP to use in its assertions to identify subjects. If unspecified, a default value of `urn:oasis:names:tc:SAML:2.0:nameid-format:persistent` will be used. A subset of the allowed values enumerated by the SAML specification are supported. */
+    nameidFormat: string;
 }
 export interface EndpointOIDC {
     /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
@@ -514,61 +609,403 @@ export interface EndpointOIDC {
     /** The set of scopes to request from the OIDC identity provider. */
     scopes: Array<string>;
 }
-export interface EventStreamCreate {
-    /** Arbitrary user-defined machine-readable data of this Event Stream. Optional, max 4096 bytes. */
+export interface EndpointBackend {
+    /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
+    enabled?: boolean;
+    /** backend to be used to back this endpoint */
+    backend: Ref;
+}
+export interface EndpointBackendMutate {
+    /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
+    enabled?: boolean;
+    /** backend to be used to back this endpoint */
+    backendId: string;
+}
+export interface EndpointWebsocketTCPConverter {
+    /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
+    enabled?: boolean;
+}
+export interface EdgeRouteItem {
+    /** unique identifier of this edge */
+    edgeId: string;
+    /** unique identifier of this edge route */
+    id: string;
+}
+export interface HTTPSEdgeRouteCreate {
+    /** unique identifier of this edge */
+    edgeId: string;
+    /** Type of match to use for this route. Valid values are "exact_path" and "path_prefix". */
+    matchType: string;
+    /** Route selector: "/blog" or "example.com" or "example.com/blog" */
+    match: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
     metadata: string;
-    /** Human-readable description of the Event Stream. Optional, max 255 bytes. */
+    /** backend module configuration or `null` */
+    backend?: EndpointBackendMutate;
+    /** ip restriction module configuration or `null` */
+    ipRestriction?: EndpointIPPolicyMutate;
+    /** circuit breaker module configuration or `null` */
+    circuitBreaker?: EndpointCircuitBreaker;
+    /** compression module configuration or `null` */
+    compression?: EndpointCompression;
+    /** request headers module configuration or `null` */
+    requestHeaders?: EndpointRequestHeaders;
+    /** response headers module configuration or `null` */
+    responseHeaders?: EndpointResponseHeaders;
+    /** webhook verification module configuration or `null` */
+    webhookVerification?: EndpointWebhookValidation;
+    /** oauth module configuration or `null` */
+    oauth?: EndpointOAuth;
+    /** saml module configuration or `null` */
+    saml?: EndpointSAMLMutate;
+    /** oidc module configuration or `null` */
+    oidc?: EndpointOIDC;
+    /** websocket to tcp adapter configuration or `null` */
+    websocketTcpConverter?: EndpointWebsocketTCPConverter;
+}
+export interface HTTPSEdgeRouteUpdate {
+    /** unique identifier of this edge */
+    edgeId: string;
+    /** unique identifier of this edge route */
+    id: string;
+    /** Type of match to use for this route. Valid values are "exact_path" and "path_prefix". */
+    matchType: string;
+    /** Route selector: "/blog" or "example.com" or "example.com/blog" */
+    match: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
     description: string;
-    /** A list of protocol-specific fields you want to collect on each event. */
-    fields: Array<string>;
-    /** The protocol that determines which events will be collected. Supported values are `tcp_connection_closed` and `http_request_complete`. */
-    eventType: string;
-    /** A list of Event Destination IDs which should be used for this Event Stream. Event Streams are required to have at least one Event Destination. */
-    destinationIds: Array<string>;
-    /** The percentage of all events you would like to capture. Valid values range from 0.01, representing 1% of all events to 1.00, representing 100% of all events. */
-    samplingRate: number;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
+    metadata: string;
+    /** backend module configuration or `null` */
+    backend?: EndpointBackendMutate;
+    /** ip restriction module configuration or `null` */
+    ipRestriction?: EndpointIPPolicyMutate;
+    /** circuit breaker module configuration or `null` */
+    circuitBreaker?: EndpointCircuitBreaker;
+    /** compression module configuration or `null` */
+    compression?: EndpointCompression;
+    /** request headers module configuration or `null` */
+    requestHeaders?: EndpointRequestHeaders;
+    /** response headers module configuration or `null` */
+    responseHeaders?: EndpointResponseHeaders;
+    /** webhook verification module configuration or `null` */
+    webhookVerification?: EndpointWebhookValidation;
+    /** oauth module configuration or `null` */
+    oauth?: EndpointOAuth;
+    /** saml module configuration or `null` */
+    saml?: EndpointSAMLMutate;
+    /** oidc module configuration or `null` */
+    oidc?: EndpointOIDC;
+    /** websocket to tcp adapter configuration or `null` */
+    websocketTcpConverter?: EndpointWebsocketTCPConverter;
 }
-export interface EventStreamUpdate {
-    /** Unique identifier for this Event Stream. */
+export interface HTTPSEdgeRoute {
+    /** unique identifier of this edge */
+    edgeId: string;
+    /** unique identifier of this edge route */
     id: string;
-    /** Arbitrary user-defined machine-readable data of this Event Stream. Optional, max 4096 bytes. */
-    metadata?: string;
-    /** Human-readable description of the Event Stream. Optional, max 255 bytes. */
-    description?: string;
-    /** A list of protocol-specific fields you want to collect on each event. */
-    fields?: Array<string>;
-    /** A list of Event Destination IDs which should be used for this Event Stream. Event Streams are required to have at least one Event Destination. */
-    destinationIds?: Array<string>;
-    /** The percentage of all events you would like to capture. Valid values range from 0.01, representing 1% of all events to 1.00, representing 100% of all events. */
-    samplingRate?: number;
+    /** timestamp when the edge configuration was created, RFC 3339 format */
+    createdAt: string;
+    /** Type of match to use for this route. Valid values are "exact_path" and "path_prefix". */
+    matchType: string;
+    /** Route selector: "/blog" or "example.com" or "example.com/blog" */
+    match: string;
+    /** URI of the edge API resource */
+    uri: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
+    metadata: string;
+    /** backend module configuration or `null` */
+    backend?: EndpointBackend;
+    /** ip restriction module configuration or `null` */
+    ipRestriction?: EndpointIPPolicy;
+    /** circuit breaker module configuration or `null` */
+    circuitBreaker?: EndpointCircuitBreaker;
+    /** compression module configuration or `null` */
+    compression?: EndpointCompression;
+    /** request headers module configuration or `null` */
+    requestHeaders?: EndpointRequestHeaders;
+    /** response headers module configuration or `null` */
+    responseHeaders?: EndpointResponseHeaders;
+    /** webhook verification module configuration or `null` */
+    webhookVerification?: EndpointWebhookValidation;
+    /** oauth module configuration or `null` */
+    oauth?: EndpointOAuth;
+    /** saml module configuration or `null` */
+    saml?: EndpointSAML;
+    /** oidc module configuration or `null` */
+    oidc?: EndpointOIDC;
+    /** websocket to tcp adapter configuration or `null` */
+    websocketTcpConverter?: EndpointWebsocketTCPConverter;
 }
-export interface EventStreamList {
-    /** The list of all Event Streams on this account. */
-    eventStreams: Array<EventStream>;
-    /** URI of the Event Stream list API resource. */
+export interface HTTPSEdgeList {
+    /** the list of all HTTPS Edges on this account */
+    httpsEdges: Array<HTTPSEdge>;
+    /** URI of the HTTPS Edge list API resource */
     uri: string;
-    /** URI of the next page, or null if there is no next page. */
+    /** URI of the next page, or null if there is no next page */
     nextPageUri?: string;
 }
-export interface EventStream {
-    /** Unique identifier for this Event Stream. */
+export interface HTTPSEdgeCreate {
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes. */
+    metadata: string;
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    mutualTls?: EndpointMutualTLSMutate;
+    tlsTermination?: EndpointTLSTerminationAtEdge;
+}
+export interface HTTPSEdgeUpdate {
+    /** unique identifier of this edge */
+    id: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description?: string;
+    /** arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes. */
+    metadata?: string;
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    mutualTls?: EndpointMutualTLSMutate;
+    tlsTermination?: EndpointTLSTerminationAtEdge;
+}
+export interface HTTPSEdge {
+    /** unique identifier of this edge */
+    id: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes. */
+    metadata: string;
+    /** timestamp when the edge configuration was created, RFC 3339 format */
+    createdAt: string;
+    /** URI of the edge API resource */
+    uri: string;
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    mutualTls?: EndpointMutualTLS;
+    tlsTermination?: EndpointTLSTermination;
+    /** routes */
+    routes: Array<HTTPSEdgeRoute>;
+}
+export interface EdgeBackendReplace {
+    id: string;
+    module: EndpointBackendMutate;
+}
+export interface EdgeIPRestrictionReplace {
+    id: string;
+    module: EndpointIPPolicyMutate;
+}
+export interface EdgeMutualTLSReplace {
+    id: string;
+    module: EndpointMutualTLSMutate;
+}
+export interface EdgeTLSTerminationReplace {
+    id: string;
+    module: EndpointTLSTermination;
+}
+export interface EdgeTLSTerminationAtEdgeReplace {
+    id: string;
+    module: EndpointTLSTerminationAtEdge;
+}
+export interface EdgeRouteBackendReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointBackendMutate;
+}
+export interface EdgeRouteIPRestrictionReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointIPPolicyMutate;
+}
+export interface EdgeRouteRequestHeadersReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointRequestHeaders;
+}
+export interface EdgeRouteResponseHeadersReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointResponseHeaders;
+}
+export interface EdgeRouteCompressionReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointCompression;
+}
+export interface EdgeRouteCircuitBreakerReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointCircuitBreaker;
+}
+export interface EdgeRouteWebhookVerificationReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointWebhookValidation;
+}
+export interface EdgeRouteOAuthReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointOAuth;
+}
+export interface EdgeRouteSAMLReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointSAMLMutate;
+}
+export interface EdgeRouteOIDCReplace {
+    edgeId: string;
+    id: string;
+    module: EndpointOIDC;
+}
+export interface EdgeRouteWebsocketTCPConverterReplace {
+    edgeId: string;
     id: string;
-    /** URI of the Event Stream API resource. */
+    module: EndpointWebsocketTCPConverter;
+}
+export interface TCPEdgeList {
+    /** the list of all TCP Edges on this account */
+    tcpEdges: Array<TCPEdge>;
+    /** URI of the TCP Edge list API resource */
     uri: string;
-    /** Timestamp when the Event Stream was created, RFC 3339 format. */
+    /** URI of the next page, or null if there is no next page */
+    nextPageUri?: string;
+}
+export interface TCPEdgeCreate {
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
+    metadata: string;
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    backend?: EndpointBackendMutate;
+    ipRestriction?: EndpointIPPolicyMutate;
+}
+export interface TCPEdgeUpdate {
+    /** unique identifier of this edge */
+    id: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description?: string;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
+    metadata?: string;
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    backend?: EndpointBackendMutate;
+    ipRestriction?: EndpointIPPolicyMutate;
+}
+export interface TCPEdge {
+    /** unique identifier of this edge */
+    id: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
+    metadata: string;
+    /** timestamp when the edge was created, RFC 3339 format */
     createdAt: string;
-    /** Arbitrary user-defined machine-readable data of this Event Stream. Optional, max 4096 bytes. */
+    /** URI of the edge API resource */
+    uri: string;
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    backend?: EndpointBackend;
+    ipRestriction?: EndpointIPPolicy;
+}
+export interface TLSEdgeList {
+    /** the list of all TLS Edges on this account */
+    tlsEdges: Array<TLSEdge>;
+    /** URI of the TLS Edge list API resource */
+    uri: string;
+    /** URI of the next page, or null if there is no next page */
+    nextPageUri?: string;
+}
+export interface TLSEdgeCreate {
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description: string;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
     metadata: string;
-    /** Human-readable description of the Event Stream. Optional, max 255 bytes. */
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    backend?: EndpointBackendMutate;
+    ipRestriction?: EndpointIPPolicyMutate;
+    mutualTls?: EndpointMutualTLSMutate;
+    tlsTermination?: EndpointTLSTermination;
+}
+export interface TLSEdgeUpdate {
+    /** unique identifier of this edge */
+    id: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
+    description?: string;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
+    metadata?: string;
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    backend?: EndpointBackendMutate;
+    ipRestriction?: EndpointIPPolicyMutate;
+    mutualTls?: EndpointMutualTLSMutate;
+    tlsTermination?: EndpointTLSTermination;
+}
+export interface TLSEdge {
+    /** unique identifier of this edge */
+    id: string;
+    /** human-readable description of what this edge will be used for; optional, max 255 bytes. */
     description: string;
-    /** A list of protocol-specific fields you want to collect on each event. */
-    fields: Array<string>;
-    /** The protocol that determines which events will be collected. Supported values are `tcp_connection_closed` and `http_request_complete`. */
-    eventType: string;
-    /** A list of Event Destination IDs which should be used for this Event Stream. Event Streams are required to have at least one Event Destination. */
-    destinationIds: Array<string>;
-    /** The percentage of all events you would like to capture. Valid values range from 0.01, representing 1% of all events to 1.00, representing 100% of all events. */
-    samplingRate: number;
+    /** arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. */
+    metadata: string;
+    /** timestamp when the edge configuration was created, RFC 3339 format */
+    createdAt: string;
+    /** URI of the edge API resource */
+    uri: string;
+    /** hostports served by this edge */
+    hostports?: Array<string>;
+    /** edge modules */
+    backend?: EndpointBackend;
+    ipRestriction?: EndpointIPPolicy;
+    mutualTls?: EndpointMutualTLS;
+    tlsTermination?: EndpointTLSTermination;
+}
+export interface Endpoint {
+    /** unique endpoint resource identifier */
+    id: string;
+    /** identifier of the region this endpoint belongs to */
+    region: string;
+    /** timestamp when the endpoint was created in RFC 3339 format */
+    createdAt: string;
+    /** timestamp when the endpoint was updated in RFC 3339 format */
+    updatedAt: string;
+    /** URL of the hostport served by this endpoint */
+    publicUrl: string;
+    /** protocol served by this endpoint. one of `http`, `https`, `tcp`, or `tls` */
+    proto: string;
+    /** hostport served by this endpoint (hostname:port) */
+    hostport: string;
+    /** whether the endpoint is `ephemeral` (served directly by an agent-initiated tunnel) or `edge` (served by an edge) */
+    type: string;
+    /** user-supplied metadata of the associated tunnel or edge object */
+    metadata: string;
+    /** the domain reserved for this endpoint */
+    domain?: Ref;
+    /** the address reserved for this endpoint */
+    tcpAddr?: Ref;
+    /** the tunnel serving requests to this endpoint, if this is an ephemeral endpoint */
+    tunnel?: Ref;
+    /** the edge serving requests to this endpoint, if this is an edge endpoint */
+    edge?: Ref;
+}
+export interface EndpointList {
+    /** the list of all active endpoints on this account */
+    endpoints: Array<Endpoint>;
+    /** URI of the endpoints list API resource */
+    uri: string;
+    /** URI of the next page, or null if there is no next page */
+    nextPageUri?: string;
 }
 export interface EventDestinationCreate {
     /** Arbitrary user-defined machine-readable data of this Event Destination. Optional, max 4096 bytes. */
@@ -665,7 +1102,7 @@ export interface EventSubscriptionCreate {
     description: string;
     /** Sources containing the types for which this event subscription will trigger */
     sources: Array<EventSourceReplace>;
-    /** A list of Event Destination IDs which should be used for this Event Stream. Event Streams are required to have at least one Event Destination. */
+    /** A list of Event Destination IDs which should be used for this Event Subscription. */
     destinationIds: Array<string>;
 }
 export interface EventSubscriptionUpdate {
@@ -677,7 +1114,7 @@ export interface EventSubscriptionUpdate {
     description?: string;
     /** Sources containing the types for which this event subscription will trigger */
     sources?: Array<EventSourceReplace>;
-    /** A list of Event Destination IDs which should be used for this Event Stream. Event Streams are required to have at least one Event Destination. */
+    /** A list of Event Destination IDs which should be used for this Event Subscription. */
     destinationIds?: Array<string>;
 }
 export interface EventSubscriptionList {
@@ -749,8 +1186,6 @@ export interface IPPolicyCreate {
     description: string;
     /** arbitrary user-defined machine-readable data of this IP policy. optional, max 4096 bytes. */
     metadata: string;
-    /** the IP policy action. Supported values are `allow` or `deny` */
-    action: string;
 }
 export interface IPPolicyUpdate {
     id: string;
@@ -770,8 +1205,6 @@ export interface IPPolicy {
     description: string;
     /** arbitrary user-defined machine-readable data of this IP policy. optional, max 4096 bytes. */
     metadata: string;
-    /** the IP policy action. Supported values are `allow` or `deny` */
-    action: string;
 }
 export interface IPPolicyList {
     /** the list of all IP policies on this account */
@@ -790,6 +1223,8 @@ export interface IPPolicyRuleCreate {
     cidr: string;
     /** ID of the IP policy this IP policy rule will be attached to */
     ipPolicyId: string;
+    /** the action to apply to the policy rule, either `allow` or `deny` */
+    action?: string;
 }
 export interface IPPolicyRuleUpdate {
     id: string;
@@ -815,6 +1250,8 @@ export interface IPPolicyRule {
     cidr: string;
     /** object describing the IP policy this IP Policy Rule belongs to */
     ipPolicy: Ref;
+    /** the action to apply to the policy rule, either `allow` or `deny` */
+    action: string;
 }
 export interface IPPolicyRuleList {
     /** the list of all IP policy rules on this account */
@@ -873,91 +1310,6 @@ export interface IPRestrictionList {
     /** URI of the next page, or null if there is no next page */
     nextPageUri?: string;
 }
-export interface IPWhitelistEntryCreate {
-    /** human-readable description of the source IPs for this IP whitelist entry. optional, max 255 bytes. */
-    description: string;
-    /** arbitrary user-defined machine-readable data of this IP whitelist entry. optional, max 4096 bytes. */
-    metadata: string;
-    /** an IP address or IP network range in CIDR notation (e.g. 10.1.1.1 or 10.1.0.0/16) of addresses that will be whitelisted to communicate with your tunnel endpoints */
-    ipNet: string;
-}
-export interface IPWhitelistEntryUpdate {
-    id: string;
-    /** human-readable description of the source IPs for this IP whitelist entry. optional, max 255 bytes. */
-    description?: string;
-    /** arbitrary user-defined machine-readable data of this IP whitelist entry. optional, max 4096 bytes. */
-    metadata?: string;
-}
-export interface IPWhitelistEntry {
-    /** unique identifier for this IP whitelist entry */
-    id: string;
-    /** URI of the IP whitelist entry API resource */
-    uri: string;
-    /** timestamp when the IP whitelist entry was created, RFC 3339 format */
-    createdAt: string;
-    /** human-readable description of the source IPs for this IP whitelist entry. optional, max 255 bytes. */
-    description: string;
-    /** arbitrary user-defined machine-readable data of this IP whitelist entry. optional, max 4096 bytes. */
-    metadata: string;
-    /** an IP address or IP network range in CIDR notation (e.g. 10.1.1.1 or 10.1.0.0/16) of addresses that will be whitelisted to communicate with your tunnel endpoints */
-    ipNet: string;
-}
-export interface IPWhitelistEntryList {
-    /** the list of all IP whitelist entries on this account */
-    whitelist: Array<IPWhitelistEntry>;
-    /** URI of the IP whitelist API resource */
-    uri: string;
-    /** URI of the next page, or null if there is no next page */
-    nextPageUri?: string;
-}
-export interface EndpointLoggingReplace {
-    id: string;
-    module: EndpointLoggingMutate;
-}
-export interface EndpointCircuitBreakerReplace {
-    id: string;
-    module: EndpointCircuitBreaker;
-}
-export interface EndpointCompressionReplace {
-    id: string;
-    module: EndpointCompression;
-}
-export interface EndpointTLSTerminationReplace {
-    id: string;
-    module: EndpointTLSTermination;
-}
-export interface EndpointIPPolicyReplace {
-    id: string;
-    module: EndpointIPPolicyMutate;
-}
-export interface EndpointMutualTLSReplace {
-    id: string;
-    module: EndpointMutualTLSMutate;
-}
-export interface EndpointRequestHeadersReplace {
-    id: string;
-    module: EndpointRequestHeaders;
-}
-export interface EndpointResponseHeadersReplace {
-    id: string;
-    module: EndpointResponseHeaders;
-}
-export interface EndpointOAuthReplace {
-    id: string;
-    module: EndpointOAuth;
-}
-export interface EndpointWebhookValidationReplace {
-    id: string;
-    module: EndpointWebhookValidation;
-}
-export interface EndpointSAMLReplace {
-    id: string;
-    module: EndpointSAMLMutate;
-}
-export interface EndpointOIDCReplace {
-    id: string;
-    module: EndpointOIDC;
-}
 export interface ReservedAddrCreate {
     /** human-readable description of what this reserved address will be used for */
     description: string;
@@ -965,8 +1317,6 @@ export interface ReservedAddrCreate {
     metadata: string;
     /** reserve the address in this geographic ngrok datacenter. Optional, default is us. (au, eu, ap, us, jp, in, sa) */
     region: string;
-    /** ID of an endpoint configuration of type tcp that will be used to handle inbound traffic to this address */
-    endpointConfigurationId: string;
 }
 export interface ReservedAddrUpdate {
     id: string;
@@ -974,8 +1324,6 @@ export interface ReservedAddrUpdate {
     description?: string;
     /** arbitrary user-defined machine-readable data of this reserved address. Optional, max 4096 bytes. */
     metadata?: string;
-    /** ID of an endpoint configuration of type tcp that will be used to handle inbound traffic to this address */
-    endpointConfigurationId?: string;
 }
 export interface ReservedAddr {
     /** unique reserved address resource identifier */
@@ -992,8 +1340,6 @@ export interface ReservedAddr {
     addr: string;
     /** reserve the address in this geographic ngrok datacenter. Optional, default is us. (au, eu, ap, us, jp, in, sa) */
     region: string;
-    /** object reference to the endpoint configuration that will be applied to traffic to this address */
-    endpointConfiguration?: Ref;
 }
 export interface ReservedAddrList {
     /** the list of all reserved addresses on this account */
@@ -1012,10 +1358,6 @@ export interface ReservedDomainCreate {
     description: string;
     /** arbitrary user-defined machine-readable data of this reserved domain. Optional, max 4096 bytes. */
     metadata: string;
-    /** ID of an endpoint configuration of type http that will be used to handle inbound http traffic to this domain */
-    httpEndpointConfigurationId?: string;
-    /** ID of an endpoint configuration of type https that will be used to handle inbound https traffic to this domain */
-    httpsEndpointConfigurationId?: string;
     /** ID of a user-uploaded TLS certificate to use for connections to targeting this domain. Optional, mutually exclusive with `certificate_management_policy`. */
     certificateId?: string;
     /** configuration for automatic management of TLS certificates for this domain, or null if automatic management is disabled. Optional, mutually exclusive with `certificate_id`. */
@@ -1027,10 +1369,6 @@ export interface ReservedDomainUpdate {
     description?: string;
     /** arbitrary user-defined machine-readable data of this reserved domain. Optional, max 4096 bytes. */
     metadata?: string;
-    /** ID of an endpoint configuration of type http that will be used to handle inbound http traffic to this domain */
-    httpEndpointConfigurationId?: string;
-    /** ID of an endpoint configuration of type https that will be used to handle inbound https traffic to this domain */
-    httpsEndpointConfigurationId?: string;
     /** ID of a user-uploaded TLS certificate to use for connections to targeting this domain. Optional, mutually exclusive with `certificate_management_policy`. */
     certificateId?: string;
     /** configuration for automatic management of TLS certificates for this domain, or null if automatic management is disabled. Optional, mutually exclusive with `certificate_id`. */
@@ -1053,16 +1391,14 @@ export interface ReservedDomain {
     region: string;
     /** DNS CNAME target for a custom hostname, or null if the reserved domain is a subdomain of *.ngrok.io */
     cnameTarget?: string;
-    /** object referencing the endpoint configuration applied to http traffic on this domain */
-    httpEndpointConfiguration?: Ref;
-    /** object referencing the endpoint configuration applied to https traffic on this domain */
-    httpsEndpointConfiguration?: Ref;
     /** object referencing the TLS certificate used for connections to this domain. This can be either a user-uploaded certificate, the most recently issued automatic one, or null otherwise. */
     certificate?: Ref;
     /** configuration for automatic management of TLS certificates for this domain, or null if automatic management is disabled */
     certificateManagementPolicy?: ReservedDomainCertPolicy;
     /** status of the automatic certificate management for this domain, or null if automatic management is disabled */
     certificateManagementStatus?: ReservedDomainCertStatus;
+    /** DNS CNAME target for the host _acme-challenge.example.com, where example.com is your reserved domain name. This is required to issue certificates for wildcard, non-ngrok reserved domains. Must be null for non-wildcard domains and ngrok subdomains. */
+    acmeChallengeCnameTarget?: string;
 }
 export interface ReservedDomainList {
     /** the list of all reserved domains on this account */
@@ -1084,12 +1420,6 @@ export interface ReservedDomainCertStatus {
     /** status of the certificate provisioning job, or null if the certificiate isn't being provisioned or renewed */
     provisioningJob?: ReservedDomainCertJob;
 }
-export interface ReservedDomainCertNSTarget {
-    /** the zone that the nameservers need to be applied to */
-    zone: string;
-    /** the nameservers the user must add */
-    nameservers: Array<string>;
-}
 export interface ReservedDomainCertJob {
     /** if present, an error code indicating why provisioning is failing. It may be either a temporary condition (INTERNAL_ERROR), or a permanent one the user must correct (DNS_ERROR). */
     errorCode?: string;
@@ -1099,8 +1429,6 @@ export interface ReservedDomainCertJob {
     startedAt: string;
     /** timestamp when the provisioning job will be retried */
     retriesAt?: string;
-    /** if present, indicates the dns nameservers that the user must configure to complete the provisioning process of a wildcard certificate */
-    nsTargets: Array<ReservedDomainCertNSTarget>;
 }
 export interface SSHCertificateAuthorityCreate {
     /** human-readable description of this SSH Certificate Authority. optional, max 255 bytes. */
@@ -1421,18 +1749,26 @@ export interface TunnelSessionsUpdate {
 export interface Tunnel {
     /** unique tunnel resource identifier */
     id: string;
-    /** URL of the tunnel's public endpoint */
+    /** URL of the ephemeral tunnel's public endpoint */
     publicUrl: string;
     /** timestamp when the tunnel was initiated in RFC 3339 format */
     startedAt: string;
     /** user-supplied metadata for the tunnel defined in the ngrok configuration file. See the tunnel [metadata configuration option](https://ngrok.com/docs#tunnel-definitions-metadata) In API version 0, this value was instead pulled from the top-level [metadata configuration option](https://ngrok.com/docs#config_metadata). */
     metadata: string;
-    /** tunnel protocol. one of `http`, `https`, `tcp` or `tls` */
+    /** tunnel protocol for ephemeral tunnels. one of `http`, `https`, `tcp` or `tls` */
     proto: string;
     /** identifier of tune region where the tunnel is running */
     region: string;
     /** reference object pointing to the tunnel session on which this tunnel was started */
     tunnelSession: Ref;
+    /** the ephemeral endpoint this tunnel is associated with, if this is an agent-initiated tunnel */
+    endpoint?: Ref;
+    /** the labels the tunnel group backends will match against, if this is a backend tunnel */
+    labels: Map<string, string>;
+    /** tunnel group backends served by this backend tunnel */
+    backends?: Array<Ref>;
+    /** upstream address the ngrok agent forwards traffic over this tunnel to. this may be expressed as a URL or a network address. */
+    forwardsTo: string;
 }
 export interface TunnelList {
     /** the list of all online tunnels on this account */