Skip to Content
Uptimeify Docs

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:

  • packageType kann den konfigurierten Paket-Key oder den Display-Namen des Pakets enthalten. Bekannte Alias-Schreibweisen wie aquisition_test werden automatisch normalisiert. Ein Wert, der auf kein Paket dieser Organisation passt, wird mit 400 und data.code invalidPackageType abgewiesen; er wird nicht mehr unverändert gespeichert.
  • companyName ist optional: der Firmenname des Kunden, auf der Kundenseite als „Firma“ angezeigt. Leer oder null leert ihn.
  • emailLanguage legt die Sprache der E-Mails fest, die dieser Kunde bekommt (Alarme, Berichte, Statusseiten): de, en oder da. null setzt sie auf die Sprache der Organisation zurück. Dieselbe Sprache gilt für SMS an diesen Kunden. Jeder andere Wert wird mit 400 abgelehnt.

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.

FeldTypStandardBeschreibung
allowSelfServiceboolean|nullnull (erben)Ob der Kunde self_service-Monitore anlegen und verwalten darf
maxSelfServiceUrlsnumber|nullnull (erben)Obergrenze für die Gesamtzahl der self_service-Monitore des Kunden über alle Monitor-Typen
canEditManagedbooleanfalseAusnahme: erlaubt diesem Kunden, managed-Monitore zu bearbeiten (Klassen-Wechsel bleiben org-only). Änderungen werden ins Audit-Log geschrieben.
enableEmailAlertsboolean|nullnull (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
enableSmsAlertsboolean|nullnull (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
enableWebhookAlertsboolean|nullnull (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
enableIntegrationAlertsboolean|nullnull (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
enablePostRequestEscalationboolean|nullnull (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

  • 400 Invalid Customer identifier
  • 400 Ungültige packageId / ungültiger packageType für diese Organisation (data.code: invalidPackageType)
  • 400 notificationPhoneNumber steht 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.
  • 401 Unauthorized
  • 403 Forbidden: Deine Rolle ist readonly, oder du bist Global Supporter
  • 404 Customer 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 mit 403.
  • 500 Failed to update customer

Auf dieser Seite