---
title: "Test upstream configuration"
method: POST
path: "/test_upstream_dns"
tags: ["global"]
---

# Test upstream configuration

`POST /test_upstream_dns`

## Request

- Base URL: `/control` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/control/test_upstream_dns`
- Auth: HTTP basic

## Request body

- UpstreamsConfig: Upstreams configuration
  - `bootstrap_dns` string[], required: Bootstrap servers, port is optional after colon. Empty value will reset it to default values.
  - `upstream_dns` string[], required: Upstream servers, port is optional after colon. Empty value will reset it to default values.
  - `private_upstream` string[]: Local PTR resolvers, port is optional after colon. Empty value will reset it to default values.

## Response `200`

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

- UpstreamsConfigResponse: Upstreams configuration response

---

[API](https://skmtc.dev/guardllamanet/apis/adguard-home.md) - [All operations](https://skmtc.dev/guardllamanet/apis/adguard-home/llms.txt) - [OpenAPI document](https://skmtc.dev/guardllamanet/apis/adguard-home/revisions/14ff21aeb363?raw)