---
title: "Eskalations-Konfiguration aktualisieren"
description: "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)

```bash
curl -X PATCH "$BASE_URL/api/escalation-config/1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookUrl": "https://deinkunde.com/webhook",
    "webhookMethod": "POST",
    "webhookHeaders": { "Content-Type": "application/json" },
    "webhookTimeout": 30,
    "webhookRetryAttempts": 3,
    "isActive": true,
    "defaultEmail": "alerts@deinkunde.com"
  }'
```

## Häufige Fehler

- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du keine ausreichenden Berechtigungen hast

## Antwort (Response)

Gibt das aktualisierte Objekt der Eskalations-Konfiguration zurück. Siehe [Error Codes](/de/api/error-codes-and-known-pitfalls) für Fehler-Antworten.