Tag-Abdeckung vorschauen

Gibt zurück, wie viele unterschiedliche Monitore eine Menge von Tags aktuell abdeckt, für den Tag-basierten (organisationsweiten) Wartungsfenster-Modus.

POST /api/maintenance-windows/preview-count

Wird vom Wartungsfenster-Formular genutzt, um vor dem Absenden eines Tag-basierten (organisationsweiten) Fensters anzuzeigen: "Dies deckt N Monitore ab". Die Abdeckung wird live ermittelt: Gezählt wird jeder Monitor, über alle Monitor-Typen hinweg, der aktuell mit mindestens einem der angegebenen Tags versehen ist, dieselbe dynamische Zugehörigkeit, die das organisationsweite Fenster selbst zur Prüfzeit verwendet.

Body

{
  "tagIds": [7]
}

Felder

Feld	Typ	Beschreibung
`tagIds`	number[]	Erforderlich, mindestens ein Eintrag. Tags, für die die Abdeckung gezählt wird. Müssen zu deiner Organisation gehören.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X POST "$BASE_URL/api/maintenance-windows/preview-count" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "tagIds": [7] }'

Antwort (Response)

{
  "count": 12
}

count ist die Anzahl unterschiedlicher (monitorType, monitorId)-Paare, die aktuell mindestens eines der angegebenen Tags tragen, nicht die Anzahl der Tags.

Häufige Fehler

Status	Beschreibung
`400` (Validierung)	`tagIds` fehlt oder ist leer. Standard-Zod-Validierungsfehler, kein `{ data: { code } }`.
`401 Unauthorized`	Nicht angemeldet.
`404` `{ data: { code: "tagNotFound" } }`	Ein `tagId` existiert nicht in deiner Organisation oder du kannst ihn nicht sehen.