Re-check a hostname's DNS target
POST
/api/zones/{zoneId}/hostnames/{id}/dns-check
Triggers an immediate DNS verification of the hostname. Resets the check counter, updates "dnsTargetStatus" and "dnsObservedValue" from the live lookup, records the check time, and reschedules the next automatic check. Takes no request body and returns the updated hostname with HTTP 200.
Authorizations
ApiToken
Long-lived API token created via POST /api/api-tokens (returned once in plaintext).
Type
API Key (header: X-API-TOKEN)
or
JWT
JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer
Type
HTTP (bearer)
Parameters
Path Parameters
zoneId*
Zone identifier
Type
Requiredstring
id*
hostname identifier
Type
Requiredstring
Responses
hostname resource created
JSON "@context": "string", "@id": "string", "@type": "string", "id": "9f1b2c3d-4e5f-6789-abcd-ef0123456789", "name": "www.example.com", "cnameTarget": "string", "cdnEnabled": false, "dnsTargetStatus": "pending", "dnsObservedValue": "string", "dnsLastCheckedAt": "2026-07-01T12:00:00+00:00", "createdAt": "2026-07-01T12:00:00+00:00", "updatedAt": "2026-07-01T12:00:00+00:00"
{
}