Uptimeify Docs

Tag einem Monitor zuweisen

Weist einem Monitor einen bestehenden Tag zu. Der Aufrufer benötigt Lesezugriff auf den Monitor und Sichtbarkeit des Tags. Die Operation ist idempotent.

POST /api/monitor-tags

Body

{
  "monitorType": "website",
  "monitorId": 101,
  "tagId": 1
}
  • monitorType (erforderlich): Typ des Monitors. Eines von: website | dns | icmp | smtp | ssh | ftp | imap_pop.
  • monitorId (erforderlich): Numerische ID des Monitors.
  • tagId (erforderlich): Numerische ID des zuzuweisenden Tags.

Diese Operation ist idempotent: Wird sie erneut aufgerufen, wenn der Tag bereits zugewiesen ist, wird die bestehende Zuweisung ohne Fehler zurückgegeben.

Beispiel (cURL)

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

curl -X POST "$BASE_URL/api/monitor-tags" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"monitorType":"website","monitorId":101,"tagId":1}'

Antwort (Response)

{
  "monitorType": "website",
  "monitorId": 101,
  "tagId": 1,
  "createdAt": "2026-06-29T12:00:00.000Z"
}

Häufige Fehler

  • 400 Bad Request wenn monitorType kein unterstützter Typ ist
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn du keinen Lesezugriff auf den Monitor hast oder den Tag nicht siehst
  • 404 Not Found wenn Monitor oder Tag nicht existieren

Auf dieser Seite