---
title: "Tag-Abdeckung vorschauen"
description: "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](/docs/api/maintenance-windows/create#tag-only-org-wide-mode)
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

```json
{
  "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)

```bash
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)

```json
{
  "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. |