v1

latestOpenAPI 3.0.32026-07-17687987.2 KB
global

Test upstream configuration

post/test_upstream_dns

Request body

bootstrap_dnsstring[] required

Bootstrap servers, port is optional after colon. Empty value will reset it to default values.

upstream_dnsstring[] required

Upstream servers, port is optional after colon. Empty value will reset it to default values.

private_upstreamstring[]

Local PTR resolvers, port is optional after colon. Empty value will reset it to default values.

Example request

{
  "bootstrap_dns": [
    "8.8.8.8:53",
    "1.1.1.1:53"
  ],
  "upstream_dns": [
    "tls://1.1.1.1",
    "tls://1.0.0.1"
  ],
  "private_upstream": [
    "tls://1.1.1.1",
    "tls://1.0.0.1"
  ]
}

Response

Status of testing each requested server, with "OK" meaning that server works, any other text means an error.

UpstreamsConfigResponse required

Upstreams configuration response