Eskalations-Konfiguration aktualisieren
Aktualisiert die Eskalations-Konfiguration. Der Parameter :id ist die Organisations-ID. Falls noch keine Konfiguration existiert, wird per Upsert eine angelegt.
PATCH /api/escalation-config/:id
Anfrage (Request Body) (alle optional)
| Feld | Typ | Beschreibung |
|---|---|---|
webhookUrl | string|null | Webhook-URL. Auf null setzen, um den Webhook-Kanal zu deaktivieren. |
webhookMethod | string | HTTP-Methode: POST, PUT oder PATCH |
webhookHeaders | object|string | JSON-Header-Objekt |
webhookBodyTemplate | string | JSON-Body-Vorlage mit {{variables}} |
webhookTimeout | integer | Timeout in Sekunden |
webhookRetryAttempts | integer | Anzahl der Wiederholungsversuche |
webhookRetryDelay | integer | Sekunden zwischen den Wiederholungsversuchen |
expectedStatusCodes | string | Kommagetrennte erwartete Statuscodes |
isActive | boolean | Aktiviert oder deaktiviert den Webhook |
defaultEmail | string | Nebeneffekt: legt einen E-Mail-Benachrichtigungskanal auf Organisationsebene an oder aktualisiert ihn |
defaultPhoneNumber | string | Nebeneffekt: legt einen SMS-Benachrichtigungskanal auf Organisationsebene an oder aktualisiert ihn |
Beispiel (cURL)
curl -X PATCH "$BASE_URL/api/escalation-config/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"webhookUrl": "https://example.com/webhook",
"webhookMethod": "POST",
"webhookHeaders": { "Content-Type": "application/json" },
"webhookTimeout": 30,
"webhookRetryAttempts": 3,
"isActive": true,
"defaultEmail": "alerts@example.com"
}'Häufige Fehler
401 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn du keine ausreichenden Berechtigungen hast
Antwort (Response)
Gibt das aktualisierte Objekt der Eskalations-Konfiguration zurück. Siehe Error Codes für Fehler-Antworten.
Eskalations-Konfiguration testen
Testet die Eskalations-Konfiguration, indem ein Test-Webhook, ein PagerDuty-Event oder eine Pushover-Benachrichtigung gesendet wird. Alle Body-Felder sind optional und überschreiben für den Test die in der DB gespeicherten Werte.
API-Tokens
API-Tokens ermöglichen den programmatischen Zugriff auf die Uptimeify-API. Tokens haben das Präfix wsm_ und können auf einen bestimmten Kunden oder organisationsweit beschränkt werden.