domains

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

Silence a watched domain's alerts without removing it.

المصادقة

أرسل مفتاح واجهة برمجة التطبيقات (API) كرمز حامل (bearer token). لا يحدد نقطة النهاية هذه إذنًا محددًا في المواصفات، لذا امنح مفتاحك الحد الأدنى الذي محتاجه وتحقق من الاستجابة بدلاً من الافتراض.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

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

هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API

التفاصيل

⚖️ 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.

المعلمات

الاسم	النوع	مطلوب	ما هو هذا
`watchId (path)`	`string`	نعم	—

جسم الطلب

الاسم	النوع	مطلوب	ما هو هذا
`until`	`string`	لا	Suppress alerts until this instant. `null` un-mutes.

الاستجابة

الاسم	النوع	مطلوب	ما هو هذا
`id`	`string`	نعم	—
`fqdn`	`string`	نعم	Normalised lowercase punycode.
`source`	`string<registered, hosting, manual>`	نعم	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`	لا	The `Domain` row, when the watched name is one of ours.
`site_id`	`string`	لا	—
`muted`	`boolean`	نعم	Whether alerts are currently suppressed.
`muted_until`	`string`	لا	—
`expires_at`	`string`	لا	⛔ `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`	لا	Whole days, or `null` when `expires_at` is unknown.
`registrar`	`string`	لا	As the registry reports it. Empty when redacted or not yet read.
`nameservers`	`string[]`	لا	—
`status`	`string[]`	لا	The EPP status set — `clientHold`, `redemptionPeriod`, `pendingDelete`, …
`last_checked_at`	`string`	لا	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`	نعم	—

الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه

401 · 403 · 404 · 422

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