public
dns

Delete a zone

Requires the canonical name in the body. Verified zones are removed from every nameserver first; recovery starts when that is confirmed.

delete/v1/dns-zones/{zoneID}

Request

  • Base URL: https://api.vozora.io
  • URL: https://api.vozora.io/v1/dns-zones/{zoneID}
  • Auth: API key in header Authorization

Path parameters

zoneIDstring required

zone id

Headers

If-Matchstring required

the zone's desired_version

Idempotency-Keystring required

caller-chosen retry token, scoped to this key

Response

accepted; removal is asynchronous

alias_healthstring
applied_versioninteger
created_atstring
delegationstring
delegation_observed_atstring
desired_versioninteger

DesiredVersion is what the next If-Match must carry; AppliedVersion is what the estate has actually served. They differ while a change is in flight, which is what a poller watches.

idstring
lifecyclestring
namestring
preparation_expires_atstring

Named for what it is, not for the token: this is when an unverified preparation lapses, and calling it a "token deadline" both puzzles a customer and makes a timestamp look like a credential.

publicationstring
recoverable_untilstring
status_urlstring
suspendedboolean
updated_atstring
verified_atstring

Changes

No recorded changes to this operation across all 1 revision of this API.