Kunden aktualisieren
Aktualisiert Kundendetails.
PATCH /api/customers/:customerPublicId
Authentifizierung
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"Anfrage (Request Body)
Alle Felder sind optional. Nicht gesendete Felder behalten ihren aktuellen Wert.
{
"name": "Neuer Name",
"email": "neu@deinkunde.com",
"status": "active",
"packageType": "business", // konfigurierter packageType oder Display-Name der Organisation
"notificationEmail": "alerts@customer-a.de",
"notificationPhoneNumber": "+491701234567",
"monthlyReportsEnabled": true,
"companyName": "Nordwind ApS",
"emailLanguage": "en",
"customFields": {
"internalReference": "KD-999"
}
}Hinweise:
packageTypekann den konfigurierten Paket-Key oder den Display-Namen des Pakets enthalten. Bekannte Alias-Schreibweisen wieaquisition_testwerden automatisch normalisiert. Ein Wert, der auf kein Paket dieser Organisation passt, wird mit400unddata.codeinvalidPackageTypeabgewiesen; er wird nicht mehr unverändert gespeichert.companyNameist optional: der Firmenname des Kunden, auf der Kundenseite als „Firma“ angezeigt. Leer odernullleert ihn.emailLanguagelegt die Sprache der E-Mails fest, die dieser Kunde bekommt (Alarme, Berichte, Statusseiten):de,enoderda.nullsetzt sie auf die Sprache der Organisation zurück. Dieselbe Sprache gilt für SMS an diesen Kunden. Jeder andere Wert wird mit400abgelehnt.
Ownership- & Berechtigungs-Overrides (optional)
Diese Felder steuern die Managed-vs.-Self-Service-Berechtigungen des Kunden und die Kanal-Typ-Policy. Sie sind org-write-gated: Schreibzugriffe eines kunden-gescopten Aufrufers auf diese Felder werden serverseitig stillschweigend ignoriert.
null bedeutet von der Paket-Konfiguration des Kunden erben.
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
allowSelfService | boolean|null | null (erben) | Ob der Kunde self_service-Monitore anlegen und verwalten darf |
maxSelfServiceUrls | number|null | null (erben) | Obergrenze für die Gesamtzahl der self_service-Monitore des Kunden über alle Monitor-Typen |
canEditManaged | boolean | false | Ausnahme: erlaubt diesem Kunden, managed-Monitore zu bearbeiten (Klassen-Wechsel bleiben org-only). Änderungen werden ins Audit-Log geschrieben. |
enableEmailAlerts | boolean|null | null (erben) | Ob die E-Mail-Kanäle deiner Organisation zu diesem Kunden alarmieren (null = wie das Paket). Kanäle, die der Kunde selbst anlegt, bleiben immer unberührt |
enableSmsAlerts | boolean|null | null (erben) | Ob die SMS-Kanäle deiner Organisation zu diesem Kunden alarmieren (null = wie das Paket). Kanäle, die der Kunde selbst anlegt, bleiben immer unberührt |
enableWebhookAlerts | boolean|null | null (erben) | Ob die Webhooks-Kanäle deiner Organisation zu diesem Kunden alarmieren (null = wie das Paket). Kanäle, die der Kunde selbst anlegt, bleiben immer unberührt |
enableIntegrationAlerts | boolean|null | null (erben) | Ob die Integrationen-Kanäle deiner Organisation zu diesem Kunden alarmieren (null = wie das Paket). Kanäle, die der Kunde selbst anlegt, bleiben immer unberührt |
enablePostRequestEscalation | boolean|null | null (erben) | Kanal-Typ-Policy-Override: POST-Request-Eskalation |
Der Legacy-notificationChannels-JSONB-Override ist deprecated: Die Kanal-Typ-Policy liegt in den enable*-Feldern oben.
Beispiel-Request
curl -X PATCH "$BASE_URL/api/customers/6bfec6f6-245a-47ce-843b-157d97d56f88" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Customer A GmbH (Updated)",
"monthlyReportsEnabled": true
}'Beispiel-Response
{
"id": 101,
"publicId": "6bfec6f6-245a-47ce-843b-157d97d56f88",
"organizationId": 1,
"name": "Customer A GmbH (Updated)",
"email": "contact@customer-a.de",
"notificationPhoneNumber": "+491701234567",
"notificationEmail": "alerts@customer-a.de",
"packageId": 3,
"packageType": "growth",
"status": "active",
"monthlyReportsEnabled": true,
"companyName": "Nordwind ApS",
"emailLanguage": "en",
"customFields": {
"internalReference": "KD-999"
},
"notificationChannels": null,
"notificationTargets": null,
"allowSelfService": null,
"maxSelfServiceUrls": null,
"canEditManaged": false,
"enableEmailAlerts": null,
"enableSmsAlerts": null,
"enableWebhookAlerts": null,
"enableIntegrationAlerts": null,
"enablePostRequestEscalation": null,
"updatedAt": "2026-02-26T19:37:00.000Z"
}packageType und Berechtigungs-Overrides: packageType ist der rohe Paket-Key des Kunden (der Wert, auf den packageType im Request-Body aufgelöst wird). Die Berechtigungs-Overrides (allowSelfService, maxSelfServiceUrls, canEditManaged, enableEmailAlerts, enableSmsAlerts, enableWebhookAlerts, enableIntegrationAlerts, enablePostRequestEscalation; null = vom Paket erben) stehen nur für Aufrufer in der Antwort, die sie auch schreiben dürfen: ein Organisations-Admin mit unbeschränktem Kundenbereich. Für einen kundengebundenen Token, jeden Nutzer ohne Admin-Rolle (editor, readonly) oder einen Global Supporter fehlen die Felder.
Häufige Fehler
400Invalid Customer identifier400UngültigepackageId/ ungültigerpackageTypefür diese Organisation (data.code:invalidPackageType)400notificationPhoneNumbersteht nicht im internationalen Format (+und Ländervorwahl) oder stammt nicht aus EU/EWR, Schweiz oder Vereinigtem Königreich (data.code:smsCountryNotAllowed). Geprüft wird nur eine geänderte Nummer.401Unauthorized403Forbidden: Deine Rolle istreadonly, oder du bist Global Supporter404Customer not found (customerNotFound): Den Kunden gibt es nicht, er gehört zu einer anderen Organisation oder liegt außerhalb deines Kunden-Scopes. Bis zum 20.10.2026 antwortete der letzte Fall mit403.500Failed to update customer