technitium 0.4.0

Typed async Rust client for the Technitium DNS Server API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# Delete Cached Zone

## Endpoint

`/api/cache/delete`

**Obsolete Path:** `/api/deleteCachedZone`

## Method

GET

## Description

Deletes a specific zone from the DNS cache. Removes all cached records associated with the specified domain name.

## Parameters

| Name | Type | Required | Conditional | Description |
|------|------|----------|-------------|-------------|
| `token` | string | Yes | No | The session token generated by the `login` or `createToken` call. |
| `domain` | string | Yes | No | The domain name to delete cached records from. |

## Authentication

Required. A valid session token must be provided via the `token` parameter.

## Permissions

Cache: Delete

## Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `status` | string | `"ok"` on success. |

## Conditional Logic Notes

- The `domain` parameter is required. Unlike `cache/list`, there is no default value; omitting it should result in an error.
- This deletes the cached zone for the exact domain specified. It does not perform recursive deletion of child zones; only the specified domain's cached entries are removed.
- After deletion, subsequent DNS queries for this domain will trigger fresh recursive resolution.

## Edge Cases

- Deleting a domain that is not currently in the cache may still return `"ok"` (idempotent behavior) rather than an error.
- The `domain` parameter must be a valid domain name. Behavior with malformed domain names is unspecified.
- This only affects the cache, not authoritative zones. Deleting a cached zone has no effect on zones the server is authoritative for.