Turn on the parking page
POST /api/v2/domains/{id}/dns/parking
Points the domain at the Hostup parking page. The call adds an A record for the parking page at the root of the DNS zone, with a TTL of 3600 seconds. It only does this when the root has no A or AAAA records. An existing website address is never replaced. The domain needs a DNS zone at Hostup. The call is idempotent: it returns 204 when the parking page is already active.
Authentication: An API key with the scope write:dns. About keys and scopes
Request
Path parameters
idstringrequiredThe domain ID (
dom_…).Example
curl -X POST "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dns/parking" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json"Responses
204 No Content. The parking page is active, or was already active.
Errors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The API key lacks a required scope or covers only some DNS records. This call changes the A record at the root of the zone. The key must cover that record. |
| 404 | The domain was not found (domain_not_found) or has no DNS zone at Hostup (domain_dns_not_found). |
| 409 | The domain has an existing root A or AAAA record, or the DNS zone has reached its record limit. |
| 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. |