domains

POST /v1/domain-watches/{watchId}/mute

Silence a watched domain's alerts without removing it.

Todos os endpoints de domains

Autenticação

Envie uma chave de API como um token bearer. Este endpoint não especifica uma permissão específica na documentação, portanto, conceda à sua chave o mínimo necessário e verifique a resposta em vez de assumir.

Este endpoint não requer um ID de organização. Sua chave já identifica a organização à qual pertence, e a resposta é delimitada a ela.

Experimente

Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.

curl -X POST https://api.zinndigital.com/v1/domain-watches/{watchId}/mute \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API

Detalhes

⚖️ Owner 2026-08-30: *"can be removed at anytime or silenced at least."* ⛔ A muted watch is **still checked** and its history still recorded — only its notifications are suppressed. Skipping the read would leave a hole, so un-muting would produce a burst of "changes" that are simply everything that happened while nobody was listening. Send `until: null` to un-mute.

Parâmetros

NomeTipoObrigatórioO que é
watchId (path)stringSim

Corpo da requisição

NomeTipoObrigatórioO que é
untilstringNãoSuppress alerts until this instant. `null` un-mutes.

Resposta

NomeTipoObrigatórioO que é
idstringSim
fqdnstringSimNormalised lowercase punycode.
sourcestring<registered, hosting, manual>SimHow it came to be watched. `registered` — we hold it. `hosting` — it is attached to a hosting account with us, whoever registered it. `manual` — the customer added it. ⛔ A domai…
domain_idstringNãoThe `Domain` row, when the watched name is one of ours.
site_idstringNão
mutedbooleanSimWhether alerts are currently suppressed.
muted_untilstringNão
expires_atstringNão⛔ `null` is **"the registry did not say"**, never "it does not expire". Render it as unknown; a client that treats it as a far-future date shows a customer a reassuring answer w…
days_until_expiryintegerNãoWhole days, or `null` when `expires_at` is unknown.
registrarstringNãoAs the registry reports it. Empty when redacted or not yet read.
nameserversstring[]Não
statusstring[]NãoThe EPP status set — `clientHold`, `redemptionPeriod`, `pendingDelete`, …
last_checked_atstringNãoWhen the registry last answered. ⛔ Every value on this row is a snapshot of the outside world taken at this instant, so it is never rendered without this beside it (§2.36).
created_atstringSim

Erros que este endpoint pode retornar

401 · 403 · 404 · 422