Sign in
ReservedDomains

Get

Get the details of a reserved domain.

get/reserved_domains/{id}

Path parameters

idstring required

a resource identifier

Headers

ngrok-versioninteger required

Response

Get the details of a reserved domain.

idstring

unique reserved domain resource identifier

uristring

URI of the reserved domain API resource

created_atstring

timestamp when the reserved domain was created, RFC 3339 format

descriptionstring

human-readable description of what this reserved domain will be used for

metadatastring

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

domainstring

hostname of the reserved domain

regionstring

deprecated: With the launch of the ngrok Global Network domains traffic is now handled globally. This field applied only to endpoints. Note that agents may still connect to specific regions. Optional, null by default. (au, eu, ap, us, jp, in, sa)

cname_targetstring

DNS CNAME target for a custom hostname, or null if the reserved domain is a subdomain of an ngrok owned domain (e.g. *.ngrok.app)

acme_challenge_cname_targetstring

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.

Changes

Changed in 1 of the 9 revisions of this API.1

  • 1994bbb047141See the full diff
    • ○

      added the optional property resolves_to to the response with the 200 status

      response-optional-property-added