domains

DELETE /v1/domains/{domainId}/disconnect

Stop hosting a connected domain's DNS, and delete its zone.

Барлық domains соңғы нүктелері

Барлық әзірлеуші құжаттамасы

Аутентификация

API кілтін bearer токені ретінде жіберіңіз. Кілтте domains.dns.manage рұқсаты болуы тиіс; онсыз кілтке 404 емес, 403 қатесі қайтарылады.

Бұл соңғы нүкте ұйым идентификаторын қабылдамайды. Сіздің кілтіңіз оның қай ұйымға тиесілі екенін өзі анықтайды және жауап соған шектеледі.

Әрекет етіп көру

Бұрыштық жақшалардағы кез келген нәрсені өз мәндеріңізбен, ал кілт орналастырушысын басқару тақтасынан алынған кілтпен алмастырыңыз.

curl -X DELETE https://api.zinndigital.com/v1/domains/{domainId}/disconnect \
  -H "Authorization: Bearer zdk_live_…"

Жүйеге кіргенсіз бе? Бақылау тақтасындағы API консолі ұйымыңыздың нақты идентификаторы мен жеке кілтіңізді автоматты түрде толтырады да, нақты жауапты көре алуыңыз үшін сұрауды тікелей жұмыс істеп тұрған API арқылы орындайды. Бұл соңғы нүктені API консолінде ашыңыз

Мәліметтер

The other half of connectDomain, and not optional: a create with no delete is how an estate fills with dead zones — config nobody serves, still counting against a provider's zone cap and indistinguishable from live config later. Removes the zone at the DNS provider, releases the provider-account placement so the pool stops counting it, then deletes the row and emits domain.disconnected. ⛔ Not domain.deleted (W42-R): that event renders to the customer as a registry release — "it is no longer yours, anyone may now register it" — which is a statement about a registration we held. Stopping DNS hosting for a name somebody else registered is a statement about our service, and the two were one event until 2026-09-09. The zone goes first: if the provider call fails this is a 503 and nothing is changed, because deleting the row first would strand the zone with nothing left pointing at it. A zone already absent at the provider is a success, not an error — otherwise a row could exist that nobody can ever remove. ⛔ Only a connected domain. One registered with us is held at a registrar with a renewal cycle attached, so removing it here would orphan the registration rather than end it — that is the transfer-out/expiry lifecycle. Attempting it is a 409. Requires domains.dns.manage.

Параметрлер

АтыTүріМіндеттіМазмұны
domainId (path)UuidИәThe domain's id.

Бұл соңғы нүкте қайтара алатын қателер

401 · 403 · 404 · 409 · 429 · 503