Delete a hostname

DELETE

/api/zones/{zoneId}/hostnames/{id}

Removes the hostname. If CDN is enabled the CDN pull-zone entry is disabled first; CDN failures surface as 400 (rejected) or 503 (temporarily unavailable). The change then takes effect on the live configuration.

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

string

Required

id*

hostname identifier

Type

string

Required

Responses

hostname resource deleted

DELETE

/api/zones/{zoneId}/hostnames/{id}

Playground

Authorization

ApiToken

Variables

Key

Value

zoneId*

id*

Samples

Powered by VitePress OpenAPI