Skip to content

Turn automatic DNSSEC on or off

POST /api/v2/domains/{id}/dnssec-auto

Turns automatic DNSSEC off or on for the domain. Send action: "exclude" to turn it off. Send action: "include" to turn it back on. Turning it on does not skip the 72-hour cooldown after a nameserver change. The response is the new state, the same as GET /api/v2/domains/{id}/dnssec-auto. Its status can still be pending or blocked. To add DS or KEY records yourself for a domain on other nameservers, use POST /api/v2/domains/{id}/dnssec.

Authentication: An API key with the scope write:domains. About keys and scopes

Request

Path parameters

idstringrequired
The domain ID (dom_…).

Body

actionstringrequired
exclude turns automatic DNSSEC off for this domain. include turns it back on. One of exclude, include.

Example

POST /api/v2/domains/{id}/dnssec-auto
curl -X POST "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dnssec-auto" \
-H "Authorization: Bearer $HOSTUP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "exclude"
}'

Responses

200 The automatic DNSSEC state after the change.

Response 200
{
"domainName": "example.se",
"status": "excluded",
"reason": "Automatic DNSSEC is disabled for this domain.",
"isEnabled": false,
"isBlocked": false,
"blockedUntil": null,
"blockReason": null,
"lastCheckedAt": "2026-04-27T12:00:00.000Z",
"lastError": null,
"nameserversChangedAt": null
}
Response fields
domainNamestring | null
The domain name.
statusstring
active (on and working), pending (waiting for the zone’s DNSSEC records to be detected), blocked (paused during the cooldown after a nameserver change), excluded (turned off for this domain), inactive (not active for this domain) or error (the last attempt failed). One of active, inactive, excluded, pending, error, blocked.
reasonstring | null
A readable explanation of status.
isEnabledboolean
True when status is active, pending or blocked.
isBlockedboolean
True while the cooldown after a nameserver change is running.
blockedUntilstring | null
When the cooldown ends. Null when not blocked.
blockReasonstring | null
Why automatic DNSSEC is paused. Null when not blocked.
lastCheckedAtstring | null
When automatic DNSSEC last checked the domain.
lastErrorstring | null
The error from the last failed attempt.
nameserversChangedAtstring | null
When the nameservers last changed.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400The body is not valid. action must be exclude or include. No other field is allowed.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller; code is domain_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.