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
idstringrequiredThe domain ID (
dom_…).Body
actionstringrequiredexclude turns automatic DNSSEC off for this domain. include turns it back on. One of exclude, include.Example
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" }'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": "include" }'Responses
200 The automatic DNSSEC state after the change.
{ "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 | nullThe domain name.
statusstringactive (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 | nullA readable explanation of
status.isEnabledbooleanTrue when
status is active, pending or blocked.isBlockedbooleanTrue while the cooldown after a nameserver change is running.
blockedUntilstring | nullWhen the cooldown ends. Null when not blocked.
blockReasonstring | nullWhy automatic DNSSEC is paused. Null when not blocked.
lastCheckedAtstring | nullWhen automatic DNSSEC last checked the domain.
lastErrorstring | nullThe error from the last failed attempt.
nameserversChangedAtstring | nullWhen the nameservers last changed.
Errors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | The body is not valid. action must be exclude or include. No other field is allowed. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is domain_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |