Uptimeify Docs

Benachrichtigungskanal aktualisieren

Aktualisiert einen Benachrichtigungskanal.

PATCH /api/notification-channels/:id

Die Config wird mit den bestehenden Geheimnissen zusammengeführt (merged), wobei verschlüsselte Felder, die nicht übergeben werden, erhalten bleiben.

Anfrage (Request Body) (alle optional)

FieldTypeDescription
typestringKanaltyp
namestringAnzeigename
configobject|stringMit bestehenden Geheimnissen zusammengeführt
prioritynumberPrioritätsreihenfolge
delaySecondsnumberVerzögerung vor dem Senden
conditionsobject|string|nullAlert-Bedingungen
allowedPackageTypesstring[]|nullPakettypen, auf die dieser Kanal angewendet wird
isActivebooleanOb der Kanal aktiv ist

Beispiel (cURL)

curl -X PATCH "$BASE_URL/api/notification-channels/1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Email Channel",
    "isActive": true
  }'

Häufige Fehler

  • 401 Unauthorized wenn du nicht authentifiziert bist
  • 403 Forbidden wenn du auf Kanäle außerhalb deines Scopes zugreifst
  • 404 Not found wenn der Kanal nicht existiert

Antwort (Response)

Gibt das aktualisierte Benachrichtigungskanal-Objekt zurück. Siehe Fehlercodes für Fehlerantworten.

Auf dieser Seite