Skip to main content
PATCH
/
edges
/
tls
/
{id}
Update
curl --request PATCH \
  --url https://api.ngrok.com/edges/tls/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'ngrok-version: <ngrok-version>' \
  --data '{
  "id": "<string>",
  "description": "<string>",
  "metadata": "<string>",
  "hostports": [
    "<string>"
  ],
  "backend": {
    "enabled": true,
    "backend_id": "<string>"
  },
  "ip_restriction": {
    "enabled": true,
    "ip_policy_ids": [
      "<string>"
    ]
  },
  "mutual_tls": {
    "enabled": true,
    "certificate_authority_ids": [
      "<string>"
    ]
  },
  "tls_termination": {
    "enabled": true,
    "terminate_at": "<string>",
    "min_version": "<string>"
  },
  "traffic_policy": {
    "enabled": true,
    "value": "<string>"
  }
}'
{
  "id": "<string>",
  "description": "<string>",
  "metadata": "<string>",
  "created_at": "<string>",
  "uri": "<string>",
  "hostports": [
    "<string>"
  ],
  "backend": {
    "enabled": true,
    "backend": {
      "id": "<string>",
      "uri": "<string>"
    }
  },
  "ip_restriction": {
    "enabled": true,
    "ip_policies": [
      {
        "id": "<string>",
        "uri": "<string>"
      }
    ]
  },
  "mutual_tls": {
    "enabled": true,
    "certificate_authorities": [
      {
        "id": "<string>",
        "uri": "<string>"
      }
    ]
  },
  "tls_termination": {
    "enabled": true,
    "terminate_at": "<string>",
    "min_version": "<string>"
  },
  "traffic_policy": {
    "enabled": true,
    "value": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

ngrok-version
integer
default:2
required

Path Parameters

id
string
required

unique identifier of this edge

Body

application/json
id
string

unique identifier of this edge

description
string

human-readable description of what this edge will be used for; optional, max 255 bytes.

metadata
string

arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes.

hostports
string[]

hostports served by this edge

backend
object

edge modules

ip_restriction
object

n/a

mutual_tls
object

n/a

tls_termination
object

n/a

traffic_policy
object

the traffic policy associated with this edge or null

Response

200 - application/json

Updates a TLS Edge by ID. If a module is not specified in the update, it will not be modified. However, each module configuration that is specified will completely replace the existing value. There is no way to delete an existing module via this API, instead use the delete module API.

id
string

unique identifier of this edge

description
string

human-readable description of what this edge will be used for; optional, max 255 bytes.

metadata
string

arbitrary user-defined machine-readable data of this edge. Optional, max 4096 bytes.

created_at
string

timestamp when the edge configuration was created, RFC 3339 format

uri
string

URI of the edge API resource

hostports
string[]

hostports served by this edge

backend
object

edge modules

ip_restriction
object

n/a

mutual_tls
object

n/a

tls_termination
object

n/a

traffic_policy
object

the traffic policy associated with this edge or null