domains
POST /v1/domain-watches/{watchId}/mute
Silence a watched domain's alerts without removing it.
Pagpapatotoo
Magpadala ng API key bilang bearer token. Ang endpoint na ito ay hindi naglatag ng tiyak na pahintulot sa pagtutukoy, kaya ibigay sa iyong key ang pinakamababang kailangan nito at suriin ang tugon sa halip na umasa.
Ang endpoint na ito ay hindi nangangailangan ng id ng organisasyon. Natutukoy na ng iyong key ang organisasyong kinabibilangan nito, at nakatuon ang tugon dito.
Subukan ito
Palitan ang anuman sa loob ng mga panaklong na may anggulo ng iyong sariling mga halaga, at ang placeholder ng key na may key mula sa iyong dashboard.
curl -X POST https://api.zinndigital.com/v1/domain-watches/{watchId}/mute \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'Nakalagda? Ang API console sa iyong dashboard ay awtomatikong naglalagay ng iyong tunay na ID ng organisasyon at sariling susi, at pinapatakbo ang kahilingan laban sa live na API upang makita mo ang aktwal na tugon. Buksan ang endpoint na ito sa console ng API
Mga Detalye
⚖️ 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.
Mga Parameter
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
watchId (path) | string | Oo | — |
Katawan ng kahilingan
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
until | string | Hindi | Suppress alerts until this instant. `null` un-mutes. |
Tugon
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
id | string | Oo | — |
fqdn | string | Oo | Normalised lowercase punycode. |
source | string<registered, hosting, manual> | Oo | How 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_id | string | Hindi | The `Domain` row, when the watched name is one of ours. |
site_id | string | Hindi | — |
muted | boolean | Oo | Whether alerts are currently suppressed. |
muted_until | string | Hindi | — |
expires_at | string | Hindi | ⛔ `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_expiry | integer | Hindi | Whole days, or `null` when `expires_at` is unknown. |
registrar | string | Hindi | As the registry reports it. Empty when redacted or not yet read. |
nameservers | string[] | Hindi | — |
status | string[] | Hindi | The EPP status set — `clientHold`, `redemptionPeriod`, `pendingDelete`, … |
last_checked_at | string | Hindi | When 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_at | string | Oo | — |
Mga error na maibabalik ng endpoint na ito
401 · 403 · 404 · 422