# AdGuard Home

> Control AdGuard Home, the network-wide ad and tracker blocker: pause protection and turn it back on, report its statistics, search the query log, block or allow domains, manage blocklists, DNS rewrites and clients, block services such as YouTube for one device, and turn safe search or parental control on or off. Start a workflow when protection is turned off or on, a domain is blocked or a new device appears.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/adguard-home

## Actions

### Add blocklist

Add a blocklist (or an allowlist) by its address. AdGuard Home downloads it straight away and starts using it; an address it can't download isn't added. One already there is turned on.

**Inputs**

- Address (`address`, text, required): The list's web address, such as https://example.com/hosts.txt, or the full path of a file on the AdGuard Home server.
- Name (`name`, text): What to call it in AdGuard Home. Leave blank to use the address.
- List type (`list_type`, text): A blocklist blocks what's on it; an allowlist never blocks it. One of: `block` (Blocklist), `allow` (Allowlist). Default: `block`.

**Outputs**

- `address` (text): Its web address, or the path of its file
- `already_listed` (true/false): True when AdGuard Home already had it; it's turned on
- `enabled` (true/false): True when it's turned on
- `id` (number): The list's ID in AdGuard Home
- `kind` (text): block for a blocklist, allow for an allowlist
- `name` (text): Its name
- `rules` (number): How many rules it has
- `updated_at` (text): When it was last downloaded (ISO 8601, UTC)

**Example output**

```json
{
  "address": "https://adguardteam.github.io/HostlistsRegistry/assets/filter_1.txt",
  "already_listed": false,
  "enabled": true,
  "id": 1,
  "kind": "block",
  "name": "AdGuard DNS filter",
  "rules": 188645,
  "updated_at": "2026-11-10T03:30:12Z"
}
```

### Add client

Add a persistent client: a device AdGuard Home knows by name, so it can have services blocked or settings of its own. A client of that name already there is given these details.

**Inputs**

- Name (`name`, text, required): What to call the device, such as Ben's tablet.
- Identifiers (`identifiers`, text, required): Its IP address, a range such as 192.168.1.0/24, its MAC address or a ClientID; several separated by commas.
- Blocked services (`services`, text): Services to block for it alone, such as YouTube; several separated by commas. Leave blank to follow the services blocked for everyone.

**Outputs**

- `already_existed` (true/false): True when a client of that name was there; it was given these details
- `blocked_service_ids` (list): The same services, by ID
- `blocked_services` (list): The services blocked for it alone, by name
- `filtering_enabled` (true/false): Its own setting: block with filters
- `identifiers` (list): Its IP addresses, ranges, MAC addresses or ClientIDs
- `name` (text): The client's name
- `parental_control_enabled` (true/false): Its own setting: parental control
- `safe_browsing_enabled` (true/false): Its own setting: browsing security
- `safe_search_enabled` (true/false): Its own setting: safe search
- `tags` (list): Its tags, such as device_tablet
- `uses_global_blocked_services` (true/false): True when it follows the services blocked for everyone
- `uses_global_settings` (true/false): True when it follows AdGuard Home's settings

**Example output**

```json
{
  "already_existed": false,
  "blocked_service_ids": [
    "youtube"
  ],
  "blocked_services": [
    "YouTube"
  ],
  "filtering_enabled": true,
  "identifiers": [
    "192.168.1.40"
  ],
  "name": "Ben's tablet",
  "parental_control_enabled": false,
  "safe_browsing_enabled": false,
  "safe_search_enabled": false,
  "tags": [
    "device_tablet"
  ],
  "uses_global_blocked_services": false,
  "uses_global_settings": true
}
```

### Add DNS rewrite

Answer a domain with an address of your choosing, such as nas.home with 192.168.1.20, as Add DNS rewrite does. One already there isn't added twice.

**Inputs**

- Domain (`domain`, text, required): The domain, such as nas.home.arpa, or *.home.arpa for every domain under it.
- Answer (`answer`, text, required): An IP address, such as 192.168.1.20, or a domain to answer as. A or AAAA keeps the real answer of that kind.
- Replace other answers (`replace`, true/false): On to remove the domain's other rewrites, so this is its only answer. Default: `false`.

**Outputs**

- `already_listed` (true/false): True when the rewrite was already there
- `answer` (text): What it's answered with: an IP address or a domain
- `domain` (text): The domain, or a wildcard such as *.example.lan
- `enabled` (true/false): True when the rewrite is turned on
- `replaced` (list): The domain's other answers that were removed

**Example output**

```json
{
  "already_listed": false,
  "answer": "192.168.1.20",
  "domain": "nas.home.arpa",
  "enabled": true,
  "replaced": []
}
```

### Block or allow domain

Block a domain, or always allow it, with a custom filtering rule: with all its subdomains or alone, for everyone or one device. It takes out the opposite rule for the same domain, and adds nothing when the rule is already there.

**Inputs**

- Domain (`domain`, text, required): The domain, such as ads.example.com (a link works too), or the whole rule when Match is A rule written out in full.
- Block or allow (`effect`, text): Block it, or allow it even when a blocklist has it. One of: `block`, `allow`. Default: `block`.
- Match (`match`, text): The domain and all its subdomains, only this exact domain, or a rule in AdGuard Home's own syntax, such as /ads[0-9]+/. One of: `subdomains` (The domain and all its subdomains), `exact` (Only this exact domain), `rule` (A rule written out in full). Default: `subdomains`.
- Only for client (`device`, text): Only for this device: its IP address, a range such as 192.168.1.0/24, or a persistent client's name. Leave blank for everyone.

**Outputs**

- `action` (text): What it does: block or allow (rewrite for a hosts-file line)
- `already_listed` (true/false): True when the rule was already there
- `client` (text): The device it's only for, if any: an IP address or a name
- `domain` (text): The domain it's about; empty for a pattern or regex
- `match` (text): subdomains (the domain and all its subdomains), exact, or other for a pattern or a rule with other options
- `replaced` (text): The opposite rule for the same domain and device that was taken out, if any
- `rule` (text): The rule as AdGuard Home keeps it, such as ||ads.example.com^

**Example output**

```json
{
  "action": "block",
  "already_listed": false,
  "client": "",
  "domain": "ads.example.com",
  "match": "subdomains",
  "replaced": "",
  "rule": "||ads.example.com^"
}
```

### Block services

Block services such as YouTube or TikTok for everyone, or for one persistent client, as Blocked services does.

**Inputs**

- Services (`services`, text, required): The services, such as YouTube or TikTok; several separated by commas.
- For client (`device`, text): Only for this persistent client. Leave blank for everyone.

**Outputs**

- `blocked_service_ids` (list): The same services, by ID
- `blocked_services` (list): Every service blocked for them now, by name
- `changed` (list): The services blocked or unblocked now, by name
- `client` (text): The client changed; empty when it was everyone

**Example output**

```json
{
  "blocked_service_ids": [
    "tiktok",
    "youtube"
  ],
  "blocked_services": [
    "TikTok",
    "YouTube"
  ],
  "changed": [
    "YouTube"
  ],
  "client": "Ben's tablet"
}
```

### Check domain

Find out what AdGuard Home would do with a domain, as Check the filtering does: blocked or not, by which rule and list, or rewritten. For everyone or one device.

**Inputs**

- Domain (`domain`, text, required): The domain, such as ads.example.com (a link works too).
- Client (`device`, text): As this device would be answered: its IP address, ClientID or persistent client name.
- Record type (`query_type`, text): The kind of DNS question, such as A (the default), AAAA or HTTPS.

**Outputs**

- `blocked` (true/false): True when AdGuard Home would block it
- `cname` (text): The domain a DNS rewrite points it to, if one does
- `domain` (text): The domain checked
- `reason` (text): What AdGuard Home would do, in words
- `rewritten_to` (list): The addresses a DNS rewrite answers with, if one does
- `rules` (list): The rules that match
- `service` (text): The blocked service it belongs to, if any
- `status` (text): AdGuard Home's reason code, such as FilteredBlackList

**Example output**

```json
{
  "blocked": true,
  "cname": "",
  "domain": "ads.example.com",
  "reason": "blocked by a filtering rule",
  "rewritten_to": [],
  "rules": [
    {
      "list_name": "AdGuard DNS filter",
      "rule": "||ads.example.com^"
    }
  ],
  "service": "",
  "status": "FilteredBlackList"
}
```

### Get statistics

Get AdGuard Home's numbers, as its Dashboard shows them: DNS queries, how many were blocked and what share, malware and adult websites blocked, and the top domains, blocked domains and clients. For a daily or weekly report.

**Inputs**

- For the last (hours) (`hours`, number): Only the last this many hours, such as 24. Leave blank for everything AdGuard Home keeps (its Statistics retention). From 1 to 2160.
- How many in each top list (`count`, number): How many top domains and clients to list. Defaults to 10. From 1 to 100.

**Outputs**

- `average_ms` (number): Average time to answer, in milliseconds
- `blocked_adult` (number): Queries for adult websites blocked by parental control
- `blocked_by_filters` (number): Queries blocked by filters (lists, rules, services)
- `blocked_malware` (number): Queries blocked as malware or phishing
- `hours` (number): The hours the numbers cover
- `percent_blocked` (number): The share blocked by filters, in percent, such as 12.5
- `safe_search_enforced` (number): Searches made safe by safe search
- `top_blocked_domains` (list): The domains blocked most, most first
- `top_clients` (list): The devices that asked most, most first
- `top_domains` (list): The domains asked for most, most first
- `total_queries` (number): DNS queries

**Example output**

```json
{
  "average_ms": 12.4,
  "blocked_adult": 0,
  "blocked_by_filters": 3127,
  "blocked_malware": 2,
  "hours": 24,
  "percent_blocked": 12.8,
  "safe_search_enforced": 14,
  "top_blocked_domains": [
    {
      "domain": "doubleclick.net",
      "queries": 412
    }
  ],
  "top_clients": [
    {
      "client": "192.168.1.23",
      "queries": 6120
    }
  ],
  "top_domains": [
    {
      "domain": "www.google.com",
      "queries": 1203
    }
  ],
  "total_queries": 24518
}
```

### Get status

Find out whether AdGuard Home's protection is on (and when a pause ends), its version, which of safe search, parental control and browsing security are on, and the services blocked for everyone.

**Inputs**: None.

**Outputs**

- `blocked_services` (list): The IDs of the services blocked for everyone
- `dns_addresses` (list): The addresses its DNS server answers on
- `filtering_enabled` (true/false): True when it blocks domains with its filters
- `parental_control_enabled` (true/false): True when its parental control is on
- `protection` (text): Whether AdGuard Home's protection is on or off
- `protection_enabled` (true/false): True while AdGuard Home is protecting
- `running` (true/false): True while its DNS server is running
- `safe_browsing_enabled` (true/false): True when browsing security (malware, phishing) is on
- `safe_search_enabled` (true/false): True when it enforces safe search
- `timer_seconds` (number): Seconds until protection turns back on by itself; 0 when it stays as it is
- `turns_on_at` (text): When protection turns back on by itself (ISO 8601, UTC); empty when it stays
- `version` (text): AdGuard Home's version, such as v0.107.80

**Example output**

```json
{
  "blocked_services": [
    "tiktok"
  ],
  "dns_addresses": [
    "192.168.1.2"
  ],
  "filtering_enabled": true,
  "parental_control_enabled": false,
  "protection": "on",
  "protection_enabled": true,
  "running": true,
  "safe_browsing_enabled": true,
  "safe_search_enabled": false,
  "timer_seconds": 0,
  "turns_on_at": "",
  "version": "v0.107.80"
}
```

### List blocklists

List AdGuard Home's blocklists and allowlists, with how many rules each has, whether it's on and when it was last downloaded.

**Inputs**

- List type (`list_type`, text): Only blocklists or only allowlists. One of: `any` (Either), `block` (Blocklist), `allow` (Allowlist). Default: `any`.

**Outputs**

- `count` (number): How many lists there are
- `lists` (list): Every blocklist and allowlist

**Example output**

```json
{
  "count": 1,
  "lists": [
    {
      "address": "https://adguardteam.github.io/HostlistsRegistry/assets/filter_1.txt",
      "enabled": true,
      "id": 1,
      "kind": "block",
      "name": "AdGuard DNS filter",
      "rules": 188645,
      "updated_at": "2026-11-10T03:30:12Z"
    }
  ]
}
```

### List clients

List AdGuard Home's persistent clients with their settings and blocked services, and, if you ask, the devices it found by itself.

**Inputs**

- Search (`search`, text): Only those with these words in them.
- Include runtime clients (`include_runtime`, true/false): On to also list the devices AdGuard Home found by itself (Runtime clients). Default: `false`.

**Outputs**

- `clients` (list): The persistent clients
- `count` (number): How many persistent clients are listed
- `runtime_clients` (list): Devices AdGuard Home found by itself, when asked for

**Example output**

```json
{
  "clients": [
    {
      "blocked_service_ids": [
        "youtube"
      ],
      "blocked_services": [
        "YouTube"
      ],
      "filtering_enabled": true,
      "identifiers": [
        "192.168.1.40"
      ],
      "name": "Ben's tablet",
      "parental_control_enabled": false,
      "safe_browsing_enabled": false,
      "safe_search_enabled": false,
      "tags": [
        "device_tablet"
      ],
      "uses_global_blocked_services": false,
      "uses_global_settings": true
    }
  ],
  "count": 1,
  "runtime_clients": [
    {
      "ip": "192.168.1.23",
      "name": "tv.lan",
      "source": "rDNS"
    }
  ]
}
```

### List custom rules

List AdGuard Home's custom filtering rules, with the domain and device each is for, block or allow rules only, or those with some words.

**Inputs**

- Block or allow (`effect`, text): Only block rules or only allow rules. One of: `any` (Either), `block`, `allow`. Default: `any`.
- Search (`search`, text): Only those with these words in them.

**Outputs**

- `count` (number): How many rules are listed
- `rules` (list): The custom filtering rules, in their order

**Example output**

```json
{
  "count": 1,
  "rules": [
    {
      "action": "block",
      "client": "",
      "domain": "ads.example.com",
      "match": "subdomains",
      "rule": "||ads.example.com^"
    }
  ]
}
```

### List DNS rewrites

List AdGuard Home's DNS rewrites: the domains it answers with an address of your choosing.

**Inputs**

- Search (`search`, text): Only those with these words in them.

**Outputs**

- `count` (number): How many rewrites are listed
- `rewrites` (list): The DNS rewrites

**Example output**

```json
{
  "count": 1,
  "rewrites": [
    {
      "answer": "192.168.1.20",
      "domain": "nas.home.arpa",
      "enabled": true
    }
  ]
}
```

### Remove blocklist

Remove a blocklist or allowlist from AdGuard Home. Nothing is removed when it isn't there.

**Inputs**

- List (`address`, text, required): The list's web address (or file path), as Filters > DNS blocklists shows it.
- List type (`list_type`, text): Only the blocklist or only the allowlist with this address. Either takes both. One of: `any` (Either), `block` (Blocklist), `allow` (Allowlist). Default: `any`.

**Outputs**

- `address` (text): The list's address
- `lists` (list): The lists removed
- `removed` (number): How many lists were removed; 0 when AdGuard Home didn't have it

**Example output**

```json
{
  "address": "https://adguardteam.github.io/HostlistsRegistry/assets/filter_1.txt",
  "lists": [
    {
      "address": "https://adguardteam.github.io/HostlistsRegistry/assets/filter_1.txt",
      "enabled": true,
      "id": 1,
      "kind": "block",
      "name": "AdGuard DNS filter",
      "rules": 188645,
      "updated_at": "2026-11-10T03:30:12Z"
    }
  ],
  "removed": 1
}
```

### Remove client

Remove a persistent client from AdGuard Home; the device then follows AdGuard Home's settings. Nothing is removed when there's none.

**Inputs**

- Client (`name`, text, required): The persistent client, by its name as Settings > Client settings shows it.

**Outputs**

- `name` (text): The client's name
- `removed` (true/false): True when it was removed; false when there was none

**Example output**

```json
{
  "name": "Ben's tablet",
  "removed": true
}
```

### Remove custom rule

Take a custom filtering rule out: the rule as written, or every rule for a domain. Nothing is removed when there's none.

**Inputs**

- Rule or domain (`rule`, text, required): A rule exactly as Filters > Custom filtering rules shows it, or a domain to take out every rule for it.
- Block or allow (`effect`, text): For a domain, take out only its block rules or only its allow rules. Either takes out both. One of: `any` (Either), `block`, `allow`. Default: `any`.

**Outputs**

- `domain` (text): The domain looked for
- `removed` (number): How many rules were taken out; 0 when there were none
- `rules` (list): The rules taken out

**Example output**

```json
{
  "domain": "ads.example.com",
  "removed": 1,
  "rules": [
    {
      "action": "block",
      "client": "",
      "domain": "ads.example.com",
      "match": "subdomains",
      "rule": "||ads.example.com^"
    }
  ]
}
```

### Remove DNS rewrite

Remove a domain's DNS rewrites, or only the one with the answer given. Nothing is removed when there's none.

**Inputs**

- Domain (`domain`, text, required): The domain, as DNS rewrites shows it.
- Answer (`answer`, text): Only the rewrite with this answer. Leave blank for all of the domain's.

**Outputs**

- `domain` (text): The domain
- `removed` (number): How many rewrites were removed; 0 when there were none
- `rewrites` (list): The rewrites removed

**Example output**

```json
{
  "domain": "nas.home.arpa",
  "removed": 1,
  "rewrites": [
    {
      "answer": "192.168.1.20",
      "domain": "nas.home.arpa",
      "enabled": true
    }
  ]
}
```

### Search query log

Find recent DNS queries in AdGuard Home's Query Log, newest first: for a domain, from a device, blocked only (or any of the Query Log's filters), within the last few minutes.

**Inputs**

- Domain (`domain`, text): Only queries for domains containing this, such as example.com, which also finds ads.example.com.
- Client (`device`, text): Only this device: its IP address, ClientID or persistent client name, as the Query Log shows it.
- Show (`status`, text): Which queries, as the Query Log's own filter names them. One of: `all` (All queries), `filtered`, `processed`, `blocked`, `blocked_services` (Blocked services), `blocked_safebrowsing` (Blocked Threats), `blocked_parental` (Blocked by Parental Control), `whitelisted` (Allowed), `rewritten`, `safe_search` (Safe Search). Default: `all`.
- Within the last (minutes) (`minutes`, number): Only queries from the last this many minutes. Leave blank for any time the Query Log keeps. From 1 to 129600.
- How many (`limit`, number): The most to list. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many queries are listed
- `queries` (list): The matching queries, newest first
- `status` (text): The kind of queries looked for, as the Query Log's filter names it

**Example output**

```json
{
  "count": 1,
  "queries": [
    {
      "answers": [
        "0.0.0.0"
      ],
      "blocked": true,
      "cached": false,
      "client_id": "",
      "client_ip": "192.168.1.23",
      "client_name": "Living room TV",
      "domain": "ads.example.com",
      "elapsed_ms": 0.12,
      "list_name": "AdGuard DNS filter",
      "query_type": "A",
      "reason": "blocked by a filtering rule",
      "response": "NOERROR",
      "rule": "||ads.example.com^",
      "service": "",
      "status": "FilteredBlackList",
      "time": "2026-11-10T17:58:03Z",
      "upstream": ""
    }
  ],
  "status": "blocked"
}
```

### Turn blocklist on or off

Turn a blocklist or allowlist on or off, keeping it in AdGuard Home, as its Enabled tick does.

**Inputs**

- List (`address`, text, required): The list's web address (or file path), as Filters > DNS blocklists shows it.
- On (`enabled`, true/false): On to use the list, off to stop using it for now. Default: `true`.
- List type (`list_type`, text): Only the blocklist or only the allowlist with this address. Either takes both. One of: `any` (Either), `block` (Blocklist), `allow` (Allowlist). Default: `any`.

**Outputs**

- `address` (text): The list's address
- `enabled` (true/false): True when it was turned on, false when turned off
- `lists` (list): The list (a blocklist and an allowlist when both have it)

**Example output**

```json
{
  "address": "https://adguardteam.github.io/HostlistsRegistry/assets/filter_1.txt",
  "enabled": true,
  "lists": [
    {
      "address": "https://adguardteam.github.io/HostlistsRegistry/assets/filter_1.txt",
      "enabled": true,
      "id": 1,
      "kind": "block",
      "name": "AdGuard DNS filter",
      "rules": 188645,
      "updated_at": "2026-11-10T03:30:12Z"
    }
  ]
}
```

### Turn off protection

Pause AdGuard Home's protection for some minutes, such as for a site that won't load, or until it's turned back on, as Disable protection does.

**Inputs**

- For how long (minutes) (`minutes`, number): Turn protection back on by itself after this many minutes, such as 10. Leave blank to keep it off until it's turned back on. From 0.1 to 10080.

**Outputs**

- `protection` (text): Whether AdGuard Home's protection is on or off
- `protection_enabled` (true/false): True while AdGuard Home is protecting
- `timer_seconds` (number): Seconds until protection turns back on by itself; 0 when it stays as it is
- `turns_on_at` (text): When protection turns back on by itself (ISO 8601, UTC); empty when it stays

**Example output**

```json
{
  "protection": "off",
  "protection_enabled": false,
  "timer_seconds": 600,
  "turns_on_at": "2026-11-10T18:10:00Z"
}
```

### Turn on protection

Turn AdGuard Home's protection back on, ending any pause.

**Inputs**: None.

**Outputs**

- `protection` (text): Whether AdGuard Home's protection is on or off
- `protection_enabled` (true/false): True while AdGuard Home is protecting
- `timer_seconds` (number): Seconds until protection turns back on by itself; 0 when it stays as it is
- `turns_on_at` (text): When protection turns back on by itself (ISO 8601, UTC); empty when it stays

**Example output**

```json
{
  "protection": "on",
  "protection_enabled": true,
  "timer_seconds": 0,
  "turns_on_at": ""
}
```

### Turn parental control on or off

Turn AdGuard's parental control web service on or off for everyone, as Use AdGuard parental control web service under Settings > General settings does: it blocks adult websites.

**Inputs**

- On (`enabled`, true/false): On to block adult websites, off to stop. Default: `true`.

**Outputs**

- `enabled` (true/false): True when parental control is on

**Example output**

```json
{
  "enabled": true
}
```

### Turn safe search on or off

Turn safe search on or off for everyone, as Use Safe Search under Settings > General settings does: family-friendly results in Google, YouTube, Bing and other search engines.

**Inputs**

- On (`enabled`, true/false): On to enforce safe search, off to stop. Default: `true`.

**Outputs**

- `enabled` (true/false): True when safe search is on
- `engines` (list): The search engines it's enforced on, such as google and youtube

**Example output**

```json
{
  "enabled": true,
  "engines": [
    "bing",
    "duckduckgo",
    "google",
    "youtube"
  ]
}
```

### Unblock services

Unblock services for everyone, or for one persistent client. A service that wasn't blocked stays as it is.

**Inputs**

- Services (`services`, text, required): The services, such as YouTube or TikTok; several separated by commas.
- For client (`device`, text): Only for this persistent client. Leave blank for everyone.

**Outputs**

- `blocked_service_ids` (list): The same services, by ID
- `blocked_services` (list): Every service blocked for them now, by name
- `changed` (list): The services blocked or unblocked now, by name
- `client` (text): The client changed; empty when it was everyone

**Example output**

```json
{
  "blocked_service_ids": [
    "tiktok"
  ],
  "blocked_services": [
    "TikTok"
  ],
  "changed": [
    "YouTube"
  ],
  "client": "Ben's tablet"
}
```

### Update blocklists

Download AdGuard Home's blocklists and allowlists again, as Check for updates does, and say how many changed and which turned-on lists have no rules (which is how a failed download looks).

**Inputs**

- List type (`list_type`, text): Only the blocklists or only the allowlists. Either updates both. One of: `any` (Either), `block` (Blocklist), `allow` (Allowlist). Default: `any`.

**Outputs**

- `count` (number): How many lists there are
- `empty_lists` (list): Turned-on lists with no rules, which is how a failed download looks
- `lists` (list): The lists, after the update
- `updated` (number): How many lists had changed and were updated

**Example output**

```json
{
  "count": 1,
  "empty_lists": [],
  "lists": [
    {
      "address": "https://adguardteam.github.io/HostlistsRegistry/assets/filter_1.txt",
      "enabled": true,
      "id": 1,
      "kind": "block",
      "name": "AdGuard DNS filter",
      "rules": 188645,
      "updated_at": "2026-11-10T03:30:12Z"
    }
  ],
  "updated": 1
}
```

### Update client

Change a persistent client: its name, identifiers, and whether it follows AdGuard Home's settings or has its own (filtering, parental control, browsing security, safe search).

**Inputs**

- Client (`name`, text, required): The persistent client, by its name as Settings > Client settings shows it.
- New name (`new_name`, text): A new name for it.
- Identifiers (`identifiers`, text): Its IP addresses, ranges, MAC addresses or ClientIDs, separated by commas, replacing the ones it has.
- Settings (`settings`, text): Follow AdGuard Home's settings, or have its own. One of: `keep` (Leave as they are), `global` (AdGuard Home's settings), `own` (Its own settings). Default: `keep`.
- Filtering (`filtering`, text): Turn blocking with filters on or off for this client alone, which gives it settings of its own. One of: `keep` (Leave as it is), `on`, `off`. Default: `keep`.
- Parental control (`parental_control`, text): Turn AdGuard parental control on or off for this client alone, which gives it settings of its own. One of: `keep` (Leave as it is), `on`, `off`. Default: `keep`.
- Browsing security (`safe_browsing`, text): Turn AdGuard browsing security on or off for this client alone, which gives it settings of its own. One of: `keep` (Leave as it is), `on`, `off`. Default: `keep`.
- Safe search (`safe_search`, text): Turn safe search on or off for this client alone, which gives it settings of its own. One of: `keep` (Leave as it is), `on`, `off`. Default: `keep`.
- Blocked services (`blocked_services`, text): Make it follow the services blocked for everyone again. To block or unblock one for it, use Block services. One of: `keep` (Leave as they are), `global` (AdGuard Home's blocked services). Default: `keep`.

**Outputs**

- `blocked_service_ids` (list): The same services, by ID
- `blocked_services` (list): The services blocked for it alone, by name
- `filtering_enabled` (true/false): Its own setting: block with filters
- `identifiers` (list): Its IP addresses, ranges, MAC addresses or ClientIDs
- `name` (text): The client's name
- `parental_control_enabled` (true/false): Its own setting: parental control
- `safe_browsing_enabled` (true/false): Its own setting: browsing security
- `safe_search_enabled` (true/false): Its own setting: safe search
- `tags` (list): Its tags, such as device_tablet
- `uses_global_blocked_services` (true/false): True when it follows the services blocked for everyone
- `uses_global_settings` (true/false): True when it follows AdGuard Home's settings

**Example output**

```json
{
  "blocked_service_ids": [
    "youtube"
  ],
  "blocked_services": [
    "YouTube"
  ],
  "filtering_enabled": true,
  "identifiers": [
    "192.168.1.40"
  ],
  "name": "Ben's tablet",
  "parental_control_enabled": false,
  "safe_browsing_enabled": false,
  "safe_search_enabled": false,
  "tags": [
    "device_tablet"
  ],
  "uses_global_blocked_services": false,
  "uses_global_settings": true
}
```
