> ## Documentation Index > Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt > Use this file to discover all available pages before exploring further. # ngrok-edges > Ngrok edge configurations and backends **Server path:** `/ngrok-edges` | **Type:** Application | **PCID required:** Yes ## Tools | Tool | Description | | ----------------------------------------------------------------------------------------- | ----------- | | [`ngrok_edges_failover_backends_create`](#ngrok_edges_failover_backends_create) | Create | | [`ngrok_edges_failover_backends_delete`](#ngrok_edges_failover_backends_delete) | Delete | | [`ngrok_edges_failover_backends_get`](#ngrok_edges_failover_backends_get) | Get | | [`ngrok_edges_failover_backends_list`](#ngrok_edges_failover_backends_list) | List | | [`ngrok_edges_failover_backends_update`](#ngrok_edges_failover_backends_update) | Update | | [`ngrok_edges_http_response_backends_create`](#ngrok_edges_http_response_backends_create) | Create | | [`ngrok_edges_http_response_backends_delete`](#ngrok_edges_http_response_backends_delete) | Delete | | [`ngrok_edges_http_response_backends_get`](#ngrok_edges_http_response_backends_get) | Get | | [`ngrok_edges_http_response_backends_list`](#ngrok_edges_http_response_backends_list) | List | | [`ngrok_edges_http_response_backends_update`](#ngrok_edges_http_response_backends_update) | Update | | [`ngrok_edges_https_create`](#ngrok_edges_https_create) | Create | | [`ngrok_edges_https_delete`](#ngrok_edges_https_delete) | Delete | | [`ngrok_edges_https_get`](#ngrok_edges_https_get) | Get | | [`ngrok_edges_https_list`](#ngrok_edges_https_list) | List | | [`ngrok_edges_https_routes_create`](#ngrok_edges_https_routes_create) | Create | | [`ngrok_edges_https_routes_delete`](#ngrok_edges_https_routes_delete) | Delete | | [`ngrok_edges_https_routes_get`](#ngrok_edges_https_routes_get) | Get | | [`ngrok_edges_https_routes_update`](#ngrok_edges_https_routes_update) | Update | | [`ngrok_edges_https_update`](#ngrok_edges_https_update) | Update | | [`ngrok_edges_static_backends_create`](#ngrok_edges_static_backends_create) | Create | | [`ngrok_edges_static_backends_delete`](#ngrok_edges_static_backends_delete) | Delete | | [`ngrok_edges_static_backends_get`](#ngrok_edges_static_backends_get) | Get | | [`ngrok_edges_static_backends_list`](#ngrok_edges_static_backends_list) | List | | [`ngrok_edges_static_backends_update`](#ngrok_edges_static_backends_update) | Update | | [`ngrok_edges_tcp_create`](#ngrok_edges_tcp_create) | Create | | [`ngrok_edges_tcp_delete`](#ngrok_edges_tcp_delete) | Delete | | [`ngrok_edges_tcp_get`](#ngrok_edges_tcp_get) | Get | | [`ngrok_edges_tcp_list`](#ngrok_edges_tcp_list) | List | | [`ngrok_edges_tcp_update`](#ngrok_edges_tcp_update) | Update | | [`ngrok_edges_tls_create`](#ngrok_edges_tls_create) | Create | | [`ngrok_edges_tls_delete`](#ngrok_edges_tls_delete) | Delete | | [`ngrok_edges_tls_get`](#ngrok_edges_tls_get) | Get | | [`ngrok_edges_tls_list`](#ngrok_edges_tls_list) | List | | [`ngrok_edges_tls_update`](#ngrok_edges_tls_update) | Update | | [`ngrok_edges_tunnel_group_backends_create`](#ngrok_edges_tunnel_group_backends_create) | Create | | [`ngrok_edges_tunnel_group_backends_delete`](#ngrok_edges_tunnel_group_backends_delete) | Delete | | [`ngrok_edges_tunnel_group_backends_get`](#ngrok_edges_tunnel_group_backends_get) | Get | | [`ngrok_edges_tunnel_group_backends_list`](#ngrok_edges_tunnel_group_backends_list) | List | | [`ngrok_edges_tunnel_group_backends_update`](#ngrok_edges_tunnel_group_backends_update) | Update | | [`ngrok_edges_weighted_backends_create`](#ngrok_edges_weighted_backends_create) | Create | | [`ngrok_edges_weighted_backends_delete`](#ngrok_edges_weighted_backends_delete) | Delete | | [`ngrok_edges_weighted_backends_get`](#ngrok_edges_weighted_backends_get) | Get | | [`ngrok_edges_weighted_backends_list`](#ngrok_edges_weighted_backends_list) | List | | [`ngrok_edges_weighted_backends_update`](#ngrok_edges_weighted_backends_update) | Update | *** ## ngrok\_edges\_failover\_backends\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | --------- | -------- | ------- | ---------------------------------------------------------------------- | | `backends` | string\[] | No | — | the ids of the child backends in order | | `description` | string | No | — | human-readable description of this backend. Optional | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "backends": { "type": "array", "items": { "type": "string" }, "description": "the ids of the child backends in order" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_failover\_backends\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_failover\_backends\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_failover\_backends\_list List **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------------------------------- | | `before_id` | string | No | — | Before Id | | `limit` | string | No | — | Maximum number of results to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "before_id": { "type": "string", "description": "Before Id" }, "limit": { "type": "string", "description": "Maximum number of results to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_failover\_backends\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | --------- | -------- | ------- | ---------------------------------------------------------------------- | | `id` | string | Yes | — | The id value | | `backends` | string\[] | No | — | the ids of the child backends in order | | `description` | string | No | — | human-readable description of this backend. Optional | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "The id value" }, "backends": { "type": "array", "items": { "type": "string" }, "description": "the ids of the child backends in order" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_http\_response\_backends\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | ------- | -------- | ------- | ---------------------------------------------------------------------- | | `body` | string | No | — | body to return as fixed content | | `description` | string | No | — | human-readable description of this backend. Optional | | `headers` | object | No | — | headers to return | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | | `status_code` | integer | No | — | status code to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "body": { "type": "string", "description": "body to return as fixed content" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "headers": { "type": "object", "description": "headers to return" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" }, "status_code": { "type": "integer", "description": "status code to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_http\_response\_backends\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_http\_response\_backends\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_http\_response\_backends\_list List **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------------------------------- | | `before_id` | string | No | — | Before Id | | `limit` | string | No | — | Maximum number of results to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "before_id": { "type": "string", "description": "Before Id" }, "limit": { "type": "string", "description": "Maximum number of results to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_http\_response\_backends\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | ------- | -------- | ------- | ---------------------------------------------------------------------- | | `id` | string | Yes | — | The id value | | `body` | string | No | — | body to return as fixed content | | `description` | string | No | — | human-readable description of this backend. Optional | | `headers` | object | No | — | headers to return | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | | `status_code` | integer | No | — | status code to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "The id value" }, "body": { "type": "string", "description": "body to return as fixed content" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "headers": { "type": "object", "description": "headers to return" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" }, "status_code": { "type": "integer", "description": "status code to return" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_https\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------- | | `description` | string | No | — | human-readable description of what this edge will be used for; optional, max 255 bytes. | | `hostports` | string\[] | No | — | hostports served by this edge | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes. | | `mutual_tls` | object | No | — | Mutual Tls | | `tls_termination` | object | No | — | Tls Termination | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "description": { "type": "string", "description": "human-readable description of what this edge will be used for; optional, max 255 bytes." }, "hostports": { "type": "array", "items": { "type": "string" }, "description": "hostports served by this edge" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes." }, "mutual_tls": { "type": "object", "description": "Mutual Tls", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "certificate_authority_ids": { "type": "array", "items": { "type": "string" }, "description": "list of certificate authorities that will be used to validate the TLS client certificate presented by the initiator of the TLS connection" } } }, "tls_termination": { "type": "object", "description": "Tls Termination", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "min_version": { "type": "string", "description": "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`." } } } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_https\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_https\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_https\_list List **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------------------------------- | | `before_id` | string | No | — | Before Id | | `limit` | string | No | — | Maximum number of results to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "before_id": { "type": "string", "description": "Before Id" }, "limit": { "type": "string", "description": "Maximum number of results to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_https\_routes\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------- | | `edge_id` | string | Yes | — | unique identifier of this edge | | `backend` | object | No | — | The backend value | | `circuit_breaker` | object | No | — | Circuit Breaker | | `compression` | object | No | — | The compression value | | `description` | string | No | — | human-readable description of what this edge will be used for; optional, max 255 bytes. | | `ip_restriction` | object | No | — | Ip Restriction | | `match` | string | Yes | — | Route selector: "/blog" or "example.com" or "example.com/blog" | | `match_type` | string | Yes | — | Type of match to use for this route. Valid values are "exact\_path" and "path\_prefix". | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. | | `oauth` | object | No | — | The oauth value | | `oidc` | object | No | — | The oidc value | | `request_headers` | object | No | — | Request Headers | | `response_headers` | object | No | — | Response Headers | | `saml` | object | No | — | The saml value | | `traffic_policy` | object | No | — | Traffic Policy | | `user_agent_filter` | object | No | — | User Agent Filter | | `webhook_verification` | object | No | — | Webhook Verification | | `websocket_tcp_converter` | object | No | — | Websocket Tcp Converter | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "edge_id": { "type": "string", "description": "unique identifier of this edge" }, "backend": { "type": "object", "description": "The backend value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "backend_id": { "type": "string", "description": "backend to be used to back this endpoint" } } }, "circuit_breaker": { "type": "object", "description": "Circuit Breaker", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "tripped_duration": { "type": "integer", "description": "Integer number of seconds after which the circuit is tripped to wait before re-evaluating upstream health" }, "rolling_window": { "type": "integer", "description": "Integer number of seconds in the statistical rolling window that metrics are retained for." }, "num_buckets": { "type": "integer", "description": "Integer number of buckets into which metrics are retained. Max 128." }, "volume_threshold": { "type": "integer", "description": "Integer number of requests in a rolling window that will trip the circuit. Helpful if traffic volume is low." }, "error_threshold_percentage": { "type": "number", "description": "Error threshold percentage should be between 0 - 1.0, not 0-100.0" } } }, "compression": { "type": "object", "description": "The compression value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" } } }, "description": { "type": "string", "description": "human-readable description of what this edge will be used for; optional, max 255 bytes." }, "ip_restriction": { "type": "object", "description": "Ip Restriction", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "ip_policy_ids": { "type": "array", "items": { "type": "string" }, "description": "list of all IP policies that will be used to check if a source IP is allowed access to the endpoint" } } }, "match": { "type": "string", "description": "Route selector: \"/blog\" or \"example.com\" or \"example.com/blog\"" }, "match_type": { "type": "string", "description": "Type of match to use for this route. Valid values are \"exact_path\" and \"path_prefix\"." }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes." }, "oauth": { "type": "object", "description": "The oauth value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "provider": { "type": "object", "description": "The provider value" }, "options_passthrough": { "type": "boolean", "description": "Do not enforce authentication on HTTP OPTIONS requests. necessary if you are supporting CORS." }, "cookie_prefix": { "type": "string", "description": "the prefix of the session cookie that ngrok sets on the http client to cache authentication. default is 'ngrok.'" }, "inactivity_timeout": { "type": "integer", "description": "Integer number of seconds of inactivity after which if the user has not accessed the endpoint, their session will time out and they will be forced to reauthenticate." }, "maximum_duration": { "type": "integer", "description": "Integer number of seconds of the maximum duration of an authenticated session. After this period is exceeded, a user must reauthenticate." }, "auth_check_interval": { "type": "integer", "description": "Integer number of seconds after which ngrok guarantees it will refresh user state from the identity provider and recheck whether the user is still authorized to access the endpoint. This is the preferred tunable to use to enforce a minimum amount of time after which a revoked user will no longer be able to access the resource." } } }, "oidc": { "type": "object", "description": "The oidc value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "options_passthrough": { "type": "boolean", "description": "Do not enforce authentication on HTTP OPTIONS requests. necessary if you are supporting CORS." }, "cookie_prefix": { "type": "string", "description": "the prefix of the session cookie that ngrok sets on the http client to cache authentication. default is 'ngrok.'" }, "inactivity_timeout": { "type": "integer", "description": "Integer number of seconds of inactivity after which if the user has not accessed the endpoint, their session will time out and they will be forced to reauthenticate." }, "maximum_duration": { "type": "integer", "description": "Integer number of seconds of the maximum duration of an authenticated session. After this period is exceeded, a user must reauthenticate." }, "issuer": { "type": "string", "description": "URL of the OIDC \"OpenID provider\". This is the base URL used for discovery." }, "client_id": { "type": "string", "description": "The OIDC app's client ID and OIDC audience." }, "client_secret": { "type": "string", "description": "The OIDC app's client secret." }, "scopes": { "type": "array", "items": { "type": "string" }, "description": "The set of scopes to request from the OIDC identity provider." } } }, "request_headers": { "type": "object", "description": "Request Headers", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "add": { "type": "object", "description": "a map of header key to header value that will be injected into the HTTP Request before being sent to the upstream application server" }, "remove": { "type": "array", "items": { "type": "string" }, "description": "a list of header names that will be removed from the HTTP Request before being sent to the upstream application server" } } }, "response_headers": { "type": "object", "description": "Response Headers", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "add": { "type": "object", "description": "a map of header key to header value that will be injected into the HTTP Response returned to the HTTP client" }, "remove": { "type": "array", "items": { "type": "string" }, "description": "a list of header names that will be removed from the HTTP Response returned to the HTTP client" } } }, "saml": { "type": "object", "description": "The saml value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "options_passthrough": { "type": "boolean", "description": "Do not enforce authentication on HTTP OPTIONS requests. necessary if you are supporting CORS." }, "cookie_prefix": { "type": "string", "description": "the prefix of the session cookie that ngrok sets on the http client to cache authentication. default is 'ngrok.'" }, "inactivity_timeout": { "type": "integer", "description": "Integer number of seconds of inactivity after which if the user has not accessed the endpoint, their session will time out and they will be forced to reauthenticate." }, "maximum_duration": { "type": "integer", "description": "Integer number of seconds of the maximum duration of an authenticated session. After this period is exceeded, a user must reauthenticate." }, "idp_metadata": { "type": "string", "description": "The full XML IdP EntityDescriptor. Your IdP may provide this to you as a a file to download or as a URL." }, "force_authn": { "type": "boolean", "description": "If true, indicates that whenever we redirect a user to the IdP for authentication that the IdP must prompt the user for authentication credentials even if the user already has a valid session with the IdP." }, "allow_idp_initiated": { "type": "boolean", "description": "If true, the IdP may initiate a login directly (e.g. the user does not need to visit the endpoint first and then be redirected). The IdP should set the `RelayState` parameter to the target URL of the resource they want the user to be redirected to after the SAML login assertion has been processed." }, "authorized_groups": { "type": "array", "items": { "type": "string" }, "description": "If present, only users who are a member of one of the listed groups may access the target endpoint." }, "nameid_format": { "type": "string", "description": "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." } } }, "traffic_policy": { "type": "object", "description": "Traffic Policy", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "value": { "type": "string", "description": "the traffic policy that should be applied to the traffic on your endpoint." } } }, "user_agent_filter": { "type": "object", "description": "User Agent Filter", "properties": { "enabled": { "type": "boolean", "description": "n/a" }, "allow": { "type": "array", "items": { "type": "string" }, "description": "n/a" }, "deny": { "type": "array", "items": { "type": "string" }, "description": "n/a" } } }, "webhook_verification": { "type": "object", "description": "Webhook Verification", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "provider": { "type": "string", "description": "a string indicating which webhook provider will be sending webhooks to this endpoint. Value must be one of the supported providers defined at https://ngrok.com/docs/cloud-edge/modules/webhook-verification" }, "secret": { "type": "string", "description": "a string secret used to validate requests from the given provider. All providers except AWS SNS require a secret" } } }, "websocket_tcp_converter": { "type": "object", "description": "Websocket Tcp Converter", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" } } } }, "required": [ "PCID", "edge_id", "match", "match_type" ] } ``` *** ## ngrok\_edges\_https\_routes\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | ------------------------------------ | | `edge_id` | string | Yes | — | unique identifier of this edge | | `id` | string | Yes | — | unique identifier of this edge route | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "edge_id": { "type": "string", "description": "unique identifier of this edge" }, "id": { "type": "string", "description": "unique identifier of this edge route" } }, "required": [ "PCID", "edge_id", "id" ] } ``` *** ## ngrok\_edges\_https\_routes\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | ------------------------------------ | | `edge_id` | string | Yes | — | unique identifier of this edge | | `id` | string | Yes | — | unique identifier of this edge route | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "edge_id": { "type": "string", "description": "unique identifier of this edge" }, "id": { "type": "string", "description": "unique identifier of this edge route" } }, "required": [ "PCID", "edge_id", "id" ] } ``` *** ## ngrok\_edges\_https\_routes\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------- | | `edge_id` | string | Yes | — | unique identifier of this edge | | `id` | string | Yes | — | unique identifier of this edge route | | `backend` | object | No | — | The backend value | | `circuit_breaker` | object | No | — | Circuit Breaker | | `compression` | object | No | — | The compression value | | `description` | string | No | — | human-readable description of what this edge will be used for; optional, max 255 bytes. | | `ip_restriction` | object | No | — | Ip Restriction | | `match` | string | No | — | Route selector: "/blog" or "example.com" or "example.com/blog" | | `match_type` | string | No | — | Type of match to use for this route. Valid values are "exact\_path" and "path\_prefix". | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. | | `oauth` | object | No | — | The oauth value | | `oidc` | object | No | — | The oidc value | | `request_headers` | object | No | — | Request Headers | | `response_headers` | object | No | — | Response Headers | | `saml` | object | No | — | The saml value | | `traffic_policy` | object | No | — | Traffic Policy | | `user_agent_filter` | object | No | — | User Agent Filter | | `webhook_verification` | object | No | — | Webhook Verification | | `websocket_tcp_converter` | object | No | — | Websocket Tcp Converter | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "edge_id": { "type": "string", "description": "unique identifier of this edge" }, "id": { "type": "string", "description": "unique identifier of this edge route" }, "backend": { "type": "object", "description": "The backend value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "backend_id": { "type": "string", "description": "backend to be used to back this endpoint" } } }, "circuit_breaker": { "type": "object", "description": "Circuit Breaker", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "tripped_duration": { "type": "integer", "description": "Integer number of seconds after which the circuit is tripped to wait before re-evaluating upstream health" }, "rolling_window": { "type": "integer", "description": "Integer number of seconds in the statistical rolling window that metrics are retained for." }, "num_buckets": { "type": "integer", "description": "Integer number of buckets into which metrics are retained. Max 128." }, "volume_threshold": { "type": "integer", "description": "Integer number of requests in a rolling window that will trip the circuit. Helpful if traffic volume is low." }, "error_threshold_percentage": { "type": "number", "description": "Error threshold percentage should be between 0 - 1.0, not 0-100.0" } } }, "compression": { "type": "object", "description": "The compression value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" } } }, "description": { "type": "string", "description": "human-readable description of what this edge will be used for; optional, max 255 bytes." }, "ip_restriction": { "type": "object", "description": "Ip Restriction", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "ip_policy_ids": { "type": "array", "items": { "type": "string" }, "description": "list of all IP policies that will be used to check if a source IP is allowed access to the endpoint" } } }, "match": { "type": "string", "description": "Route selector: \"/blog\" or \"example.com\" or \"example.com/blog\"" }, "match_type": { "type": "string", "description": "Type of match to use for this route. Valid values are \"exact_path\" and \"path_prefix\"." }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes." }, "oauth": { "type": "object", "description": "The oauth value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "provider": { "type": "object", "description": "The provider value" }, "options_passthrough": { "type": "boolean", "description": "Do not enforce authentication on HTTP OPTIONS requests. necessary if you are supporting CORS." }, "cookie_prefix": { "type": "string", "description": "the prefix of the session cookie that ngrok sets on the http client to cache authentication. default is 'ngrok.'" }, "inactivity_timeout": { "type": "integer", "description": "Integer number of seconds of inactivity after which if the user has not accessed the endpoint, their session will time out and they will be forced to reauthenticate." }, "maximum_duration": { "type": "integer", "description": "Integer number of seconds of the maximum duration of an authenticated session. After this period is exceeded, a user must reauthenticate." }, "auth_check_interval": { "type": "integer", "description": "Integer number of seconds after which ngrok guarantees it will refresh user state from the identity provider and recheck whether the user is still authorized to access the endpoint. This is the preferred tunable to use to enforce a minimum amount of time after which a revoked user will no longer be able to access the resource." } } }, "oidc": { "type": "object", "description": "The oidc value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "options_passthrough": { "type": "boolean", "description": "Do not enforce authentication on HTTP OPTIONS requests. necessary if you are supporting CORS." }, "cookie_prefix": { "type": "string", "description": "the prefix of the session cookie that ngrok sets on the http client to cache authentication. default is 'ngrok.'" }, "inactivity_timeout": { "type": "integer", "description": "Integer number of seconds of inactivity after which if the user has not accessed the endpoint, their session will time out and they will be forced to reauthenticate." }, "maximum_duration": { "type": "integer", "description": "Integer number of seconds of the maximum duration of an authenticated session. After this period is exceeded, a user must reauthenticate." }, "issuer": { "type": "string", "description": "URL of the OIDC \"OpenID provider\". This is the base URL used for discovery." }, "client_id": { "type": "string", "description": "The OIDC app's client ID and OIDC audience." }, "client_secret": { "type": "string", "description": "The OIDC app's client secret." }, "scopes": { "type": "array", "items": { "type": "string" }, "description": "The set of scopes to request from the OIDC identity provider." } } }, "request_headers": { "type": "object", "description": "Request Headers", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "add": { "type": "object", "description": "a map of header key to header value that will be injected into the HTTP Request before being sent to the upstream application server" }, "remove": { "type": "array", "items": { "type": "string" }, "description": "a list of header names that will be removed from the HTTP Request before being sent to the upstream application server" } } }, "response_headers": { "type": "object", "description": "Response Headers", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "add": { "type": "object", "description": "a map of header key to header value that will be injected into the HTTP Response returned to the HTTP client" }, "remove": { "type": "array", "items": { "type": "string" }, "description": "a list of header names that will be removed from the HTTP Response returned to the HTTP client" } } }, "saml": { "type": "object", "description": "The saml value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "options_passthrough": { "type": "boolean", "description": "Do not enforce authentication on HTTP OPTIONS requests. necessary if you are supporting CORS." }, "cookie_prefix": { "type": "string", "description": "the prefix of the session cookie that ngrok sets on the http client to cache authentication. default is 'ngrok.'" }, "inactivity_timeout": { "type": "integer", "description": "Integer number of seconds of inactivity after which if the user has not accessed the endpoint, their session will time out and they will be forced to reauthenticate." }, "maximum_duration": { "type": "integer", "description": "Integer number of seconds of the maximum duration of an authenticated session. After this period is exceeded, a user must reauthenticate." }, "idp_metadata": { "type": "string", "description": "The full XML IdP EntityDescriptor. Your IdP may provide this to you as a a file to download or as a URL." }, "force_authn": { "type": "boolean", "description": "If true, indicates that whenever we redirect a user to the IdP for authentication that the IdP must prompt the user for authentication credentials even if the user already has a valid session with the IdP." }, "allow_idp_initiated": { "type": "boolean", "description": "If true, the IdP may initiate a login directly (e.g. the user does not need to visit the endpoint first and then be redirected). The IdP should set the `RelayState` parameter to the target URL of the resource they want the user to be redirected to after the SAML login assertion has been processed." }, "authorized_groups": { "type": "array", "items": { "type": "string" }, "description": "If present, only users who are a member of one of the listed groups may access the target endpoint." }, "nameid_format": { "type": "string", "description": "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." } } }, "traffic_policy": { "type": "object", "description": "Traffic Policy", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "value": { "type": "string", "description": "the traffic policy that should be applied to the traffic on your endpoint." } } }, "user_agent_filter": { "type": "object", "description": "User Agent Filter", "properties": { "enabled": { "type": "boolean", "description": "n/a" }, "allow": { "type": "array", "items": { "type": "string" }, "description": "n/a" }, "deny": { "type": "array", "items": { "type": "string" }, "description": "n/a" } } }, "webhook_verification": { "type": "object", "description": "Webhook Verification", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "provider": { "type": "string", "description": "a string indicating which webhook provider will be sending webhooks to this endpoint. Value must be one of the supported providers defined at https://ngrok.com/docs/cloud-edge/modules/webhook-verification" }, "secret": { "type": "string", "description": "a string secret used to validate requests from the given provider. All providers except AWS SNS require a secret" } } }, "websocket_tcp_converter": { "type": "object", "description": "Websocket Tcp Converter", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" } } } }, "required": [ "PCID", "edge_id", "id" ] } ``` *** ## ngrok\_edges\_https\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------- | | `id` | string | Yes | — | unique identifier of this edge | | `description` | string | No | — | human-readable description of what this edge will be used for; optional, max 255 bytes. | | `hostports` | string\[] | No | — | hostports served by this edge | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes. | | `mutual_tls` | object | No | — | Mutual Tls | | `tls_termination` | object | No | — | Tls Termination | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "unique identifier of this edge" }, "description": { "type": "string", "description": "human-readable description of what this edge will be used for; optional, max 255 bytes." }, "hostports": { "type": "array", "items": { "type": "string" }, "description": "hostports served by this edge" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes." }, "mutual_tls": { "type": "object", "description": "Mutual Tls", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "certificate_authority_ids": { "type": "array", "items": { "type": "string" }, "description": "list of certificate authorities that will be used to validate the TLS client certificate presented by the initiator of the TLS connection" } } }, "tls_termination": { "type": "object", "description": "Tls Termination", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "min_version": { "type": "string", "description": "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`." } } } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_static\_backends\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------- | | `address` | string | No | — | the address to forward to | | `description` | string | No | — | human-readable description of this backend. Optional | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | | `tls` | object | No | — | The tls value | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "address": { "type": "string", "description": "the address to forward to" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" }, "tls": { "type": "object", "description": "The tls value", "properties": { "enabled": { "type": "boolean", "description": "if TLS is checked" } } } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_static\_backends\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_static\_backends\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_static\_backends\_list List **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------------------------------- | | `before_id` | string | No | — | Before Id | | `limit` | string | No | — | Maximum number of results to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "before_id": { "type": "string", "description": "Before Id" }, "limit": { "type": "string", "description": "Maximum number of results to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_static\_backends\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------- | | `id` | string | Yes | — | The id value | | `address` | string | No | — | the address to forward to | | `description` | string | No | — | human-readable description of this backend. Optional | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | | `tls` | object | No | — | The tls value | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "The id value" }, "address": { "type": "string", "description": "the address to forward to" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" }, "tls": { "type": "object", "description": "The tls value", "properties": { "enabled": { "type": "boolean", "description": "if TLS is checked" } } } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tcp\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------- | | `backend` | object | No | — | The backend value | | `description` | string | No | — | human-readable description of what this edge will be used for; optional, max 255 bytes. | | `hostports` | string\[] | No | — | hostports served by this edge | | `ip_restriction` | object | No | — | Ip Restriction | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. | | `traffic_policy` | object | No | — | Traffic Policy | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "backend": { "type": "object", "description": "The backend value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "backend_id": { "type": "string", "description": "backend to be used to back this endpoint" } } }, "description": { "type": "string", "description": "human-readable description of what this edge will be used for; optional, max 255 bytes." }, "hostports": { "type": "array", "items": { "type": "string" }, "description": "hostports served by this edge" }, "ip_restriction": { "type": "object", "description": "Ip Restriction", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "ip_policy_ids": { "type": "array", "items": { "type": "string" }, "description": "list of all IP policies that will be used to check if a source IP is allowed access to the endpoint" } } }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes." }, "traffic_policy": { "type": "object", "description": "Traffic Policy", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "value": { "type": "string", "description": "the traffic policy that should be applied to the traffic on your endpoint." } } } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_tcp\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tcp\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tcp\_list List **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------------------------------- | | `before_id` | string | No | — | Before Id | | `limit` | string | No | — | Maximum number of results to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "before_id": { "type": "string", "description": "Before Id" }, "limit": { "type": "string", "description": "Maximum number of results to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_tcp\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------- | | `id` | string | Yes | — | unique identifier of this edge | | `backend` | object | No | — | The backend value | | `description` | string | No | — | human-readable description of what this edge will be used for; optional, max 255 bytes. | | `hostports` | string\[] | No | — | hostports served by this edge | | `ip_restriction` | object | No | — | Ip Restriction | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. | | `traffic_policy` | object | No | — | Traffic Policy | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "unique identifier of this edge" }, "backend": { "type": "object", "description": "The backend value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "backend_id": { "type": "string", "description": "backend to be used to back this endpoint" } } }, "description": { "type": "string", "description": "human-readable description of what this edge will be used for; optional, max 255 bytes." }, "hostports": { "type": "array", "items": { "type": "string" }, "description": "hostports served by this edge" }, "ip_restriction": { "type": "object", "description": "Ip Restriction", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "ip_policy_ids": { "type": "array", "items": { "type": "string" }, "description": "list of all IP policies that will be used to check if a source IP is allowed access to the endpoint" } } }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes." }, "traffic_policy": { "type": "object", "description": "Traffic Policy", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "value": { "type": "string", "description": "the traffic policy that should be applied to the traffic on your endpoint." } } } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tls\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------- | | `backend` | object | No | — | The backend value | | `description` | string | No | — | human-readable description of what this edge will be used for; optional, max 255 bytes. | | `hostports` | string\[] | No | — | hostports served by this edge | | `ip_restriction` | object | No | — | Ip Restriction | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. | | `mutual_tls` | object | No | — | Mutual Tls | | `tls_termination` | object | No | — | Tls Termination | | `traffic_policy` | object | No | — | Traffic Policy | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "backend": { "type": "object", "description": "The backend value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "backend_id": { "type": "string", "description": "backend to be used to back this endpoint" } } }, "description": { "type": "string", "description": "human-readable description of what this edge will be used for; optional, max 255 bytes." }, "hostports": { "type": "array", "items": { "type": "string" }, "description": "hostports served by this edge" }, "ip_restriction": { "type": "object", "description": "Ip Restriction", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "ip_policy_ids": { "type": "array", "items": { "type": "string" }, "description": "list of all IP policies that will be used to check if a source IP is allowed access to the endpoint" } } }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes." }, "mutual_tls": { "type": "object", "description": "Mutual Tls", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "certificate_authority_ids": { "type": "array", "items": { "type": "string" }, "description": "list of certificate authorities that will be used to validate the TLS client certificate presented by the initiator of the TLS connection" } } }, "tls_termination": { "type": "object", "description": "Tls Termination", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "terminate_at": { "type": "string", "description": "`edge` if the ngrok edge should terminate TLS traffic, `upstream` if TLS traffic should be passed through to the upstream ngrok agent / application server for termination. if `upstream` is chosen, most other modules will be disallowed because they rely on the ngrok edge being able to access the underlying traffic." }, "min_version": { "type": "string", "description": "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`." } } }, "traffic_policy": { "type": "object", "description": "Traffic Policy", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "value": { "type": "string", "description": "the traffic policy that should be applied to the traffic on your endpoint." } } } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_tls\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tls\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tls\_list List **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------------------------------- | | `before_id` | string | No | — | Before Id | | `limit` | string | No | — | Maximum number of results to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "before_id": { "type": "string", "description": "Before Id" }, "limit": { "type": "string", "description": "Maximum number of results to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_tls\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------- | | `id` | string | Yes | — | unique identifier of this edge | | `backend` | object | No | — | The backend value | | `description` | string | No | — | human-readable description of what this edge will be used for; optional, max 255 bytes. | | `hostports` | string\[] | No | — | hostports served by this edge | | `ip_restriction` | object | No | — | Ip Restriction | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes. | | `mutual_tls` | object | No | — | Mutual Tls | | `tls_termination` | object | No | — | Tls Termination | | `traffic_policy` | object | No | — | Traffic Policy | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "unique identifier of this edge" }, "backend": { "type": "object", "description": "The backend value", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "backend_id": { "type": "string", "description": "backend to be used to back this endpoint" } } }, "description": { "type": "string", "description": "human-readable description of what this edge will be used for; optional, max 255 bytes." }, "hostports": { "type": "array", "items": { "type": "string" }, "description": "hostports served by this edge" }, "ip_restriction": { "type": "object", "description": "Ip Restriction", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "ip_policy_ids": { "type": "array", "items": { "type": "string" }, "description": "list of all IP policies that will be used to check if a source IP is allowed access to the endpoint" } } }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes." }, "mutual_tls": { "type": "object", "description": "Mutual Tls", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "certificate_authority_ids": { "type": "array", "items": { "type": "string" }, "description": "list of certificate authorities that will be used to validate the TLS client certificate presented by the initiator of the TLS connection" } } }, "tls_termination": { "type": "object", "description": "Tls Termination", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "terminate_at": { "type": "string", "description": "`edge` if the ngrok edge should terminate TLS traffic, `upstream` if TLS traffic should be passed through to the upstream ngrok agent / application server for termination. if `upstream` is chosen, most other modules will be disallowed because they rely on the ngrok edge being able to access the underlying traffic." }, "min_version": { "type": "string", "description": "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`." } } }, "traffic_policy": { "type": "object", "description": "Traffic Policy", "properties": { "enabled": { "type": "boolean", "description": "`true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified" }, "value": { "type": "string", "description": "the traffic policy that should be applied to the traffic on your endpoint." } } } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tunnel\_group\_backends\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------- | | `description` | string | No | — | human-readable description of this backend. Optional | | `labels` | object | No | — | labels to watch for tunnels on, e.g. app->foo, dc->bar | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "labels": { "type": "object", "description": "labels to watch for tunnels on, e.g. app->foo, dc->bar" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_tunnel\_group\_backends\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tunnel\_group\_backends\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_tunnel\_group\_backends\_list List **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------------------------------- | | `before_id` | string | No | — | Before Id | | `limit` | string | No | — | Maximum number of results to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "before_id": { "type": "string", "description": "Before Id" }, "limit": { "type": "string", "description": "Maximum number of results to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_tunnel\_group\_backends\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------- | | `id` | string | Yes | — | The id value | | `description` | string | No | — | human-readable description of this backend. Optional | | `labels` | object | No | — | labels to watch for tunnels on, e.g. app->foo, dc->bar | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "The id value" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "labels": { "type": "object", "description": "labels to watch for tunnels on, e.g. app->foo, dc->bar" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_weighted\_backends\_create Create **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------- | | `backends` | object | No | — | the ids of the child backends to their weights \[0-10000] | | `description` | string | No | — | human-readable description of this backend. Optional | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "backends": { "type": "object", "description": "the ids of the child backends to their weights [0-10000]" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_weighted\_backends\_delete Delete **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_weighted\_backends\_get Get **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------ | -------- | ------- | --------------------- | | `id` | string | Yes | — | a resource identifier | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "a resource identifier" } }, "required": [ "PCID", "id" ] } ``` *** ## ngrok\_edges\_weighted\_backends\_list List **Parameters:** | Parameter | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | ----------------------------------- | | `before_id` | string | No | — | Before Id | | `limit` | string | No | — | Maximum number of results to return | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "before_id": { "type": "string", "description": "Before Id" }, "limit": { "type": "string", "description": "Maximum number of results to return" } }, "required": [ "PCID" ] } ``` *** ## ngrok\_edges\_weighted\_backends\_update Update **Parameters:** | Parameter | Type | Required | Default | Description | | ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------- | | `id` | string | Yes | — | The id value | | `backends` | object | No | — | the ids of the child backends to their weights \[0-10000] | | `description` | string | No | — | human-readable description of this backend. Optional | | `metadata` | string | No | — | arbitrary user-defined machine-readable data of this backend. Optional | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "id": { "type": "string", "description": "The id value" }, "backends": { "type": "object", "description": "the ids of the child backends to their weights [0-10000]" }, "description": { "type": "string", "description": "human-readable description of this backend. Optional" }, "metadata": { "type": "string", "description": "arbitrary user-defined machine-readable data of this backend. Optional" } }, "required": [ "PCID", "id" ] } ```