Skip to content

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

idstringrequired
The domain ID (dom_…).

Example

POST /api/v2/domains/{id}/dns/parking
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.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. 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.
404The domain was not found (domain_not_found) or has no DNS zone at Hostup (domain_dns_not_found).
409The domain has an existing root A or AAAA record, or the DNS zone has reached its record limit.
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.