Client — DNS

Updated Oct 4, 2026 Markdown

GET /api/v1/client/dns/{domain}

Get DNS zone (client)

Return the DNS zone and its records for a domain owned by the authenticated client.

Path parameters:

Name Type Required Notes
domain string yes —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

shell
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/client/dns/{domain}

GET /api/v1/client/dns/{domain}/dnssec

Get DNSSEC status (client)

Return DNSSEC status for a domain owned by the authenticated client.

Path parameters:

Name Type Required Notes
domain string yes —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

shell
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/client/dns/{domain}/dnssec

POST /api/v1/client/dns/{domain}/dnssec/disable

Disable DNSSEC (client)

Disable DNSSEC for a domain owned by the authenticated client.

Path parameters:

Name Type Required Notes
domain string yes —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

shell
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/client/dns/{domain}/dnssec/disable

POST /api/v1/client/dns/{domain}/dnssec/enable

Enable DNSSEC (client)

Enable DNSSEC for a domain owned by the authenticated client.

Path parameters:

Name Type Required Notes
domain string yes —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

shell
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/client/dns/{domain}/dnssec/enable

POST /api/v1/client/dns/{domain}/records

Add DNS record (client)

Add a DNS record to a zone owned by the authenticated client.

Path parameters:

Name Type Required Notes
domain string yes —

Body fields:

Field Type Required Notes
content string yes —
name string yes —
port integer no —
priority integer no —
record_type DNSRecordType yes enum: A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, SOA, PTR
ttl integer no default 3600; minimum=60.0; maximum=86400.0
weight integer no —

Request body example:

JSON
{
  "content": "string",
  "name": "string",
  "port": 0,
  "priority": 0,
  "record_type": "A",
  "ttl": 3600,
  "weight": 0
}

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

shell
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/client/dns/{domain}/records

DELETE /api/v1/client/dns/{domain}/records/{record_id}

Delete DNS record (client)

Delete a DNS record from a zone owned by the authenticated client.

Path parameters:

Name Type Required Notes
domain string yes —
record_id integer yes —

Responses:

Status Schema Description
200 MessageResponse Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "message": "string",
  "status": "success"
}

cURL example:

shell
curl -X DELETE \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/client/dns/{domain}/records/{record_id}

PUT /api/v1/client/dns/{domain}/records/{record_id}

Update DNS record (client)

Update an existing DNS record in a zone owned by the authenticated client.

Path parameters:

Name Type Required Notes
domain string yes —
record_id integer yes —

Body fields:

Field Type Required Notes
content string no —
port integer no —
priority integer no —
ttl integer no —
weight integer no —

Request body example:

JSON
{
  "content": "string",
  "port": 0,
  "priority": 0,
  "ttl": 60.0,
  "weight": 0
}

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

shell
curl -X PUT \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/client/dns/{domain}/records/{record_id}

POST /api/v1/client/dns/{domain}/zone

Bootstrap DNS zone (client)

Create a DNS zone for a domain owned by the authenticated client. Idempotent — returns existing zone if already created.

Path parameters:

Name Type Required Notes
domain string yes —

Responses:

Status Schema Description
200 ApiSuccess_dict_str__Any__ Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{
  "data": {},
  "message": "",
  "status": "success",
  "warnings": [
    "string"
  ]
}

cURL example:

shell
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/client/dns/{domain}/zone
Still Need Help?

Our support team is here around the clock for anything you can't find above.

Contact Us Open a Ticket