Benutzer aktualisieren

PATCH /api/users/:id

Anfrage (Request Body)Ankerlink kopieren

{
  "firstName": "Jane",
  "lastName": "Smith",
  "role": "admin",
  "isActive": true,
  "customerIds": ["11111111-1111-4111-8111-111111111111", "22222222-2222-4222-8222-222222222222"] // Update der Liste zugewiesener Kunden per Public ID
}

Hinweise:

• customerIds akzeptiert Customer-Public-IDs und weiterhin Legacy-Integer-IDs.
• Für neue Integrationen sind Public IDs die bevorzugte Form.
• firstName und lastName sind auf 100 Zeichen begrenzt, role muss admin, editor, readonly oder responder sein, customerIds fasst höchstens 500 Einträge.
• Die globalen Plattform-Flags (isGlobalAdmin, isGlobalSupporter) lassen sich über diesen Endpunkt nicht setzen; werden sie mitgeschickt, ignoriert der Server sie.

SchutzregelnAnkerlink kopieren

• Du kannst dich nicht selbst deaktivieren und nicht deine eigene Rolle ändern.
• Der letzte aktive Admin einer Organisation kann weder herabgestuft noch deaktiviert werden. Ernenne zuerst einen weiteren Benutzer zum admin.
• Ein Benutzer, der globaler Admin oder globaler Supporter ist, kann nur von einem globalen Admin bearbeitet werden.

Häufige FehlerAnkerlink kopieren

• 400 Bad Request wenn der Body die Validierung nicht besteht (unbekannter Feldtyp, zu lange Zeichenkette, customerIds ist kein Array)
• 400 Bad Request mit data.code: "invalidRole" wenn role keinen der erlaubten Werte trägt
• 400 Bad Request mit data.code: "userSelfChangeForbidden" wenn du dich selbst deaktivieren oder deine eigene Rolle ändern willst
• 400 Bad Request mit data.code: "lastAdminProtected" wenn die Änderung die Organisation ohne aktiven Admin zurücklassen würde
• 403 Forbidden mit data.code: "globalUserProtected" wenn ein Organisations-Admin einen globalen Admin oder globalen Supporter bearbeiten will
• 404 Not Found wenn der Benutzer in deiner Organisation nicht existiert

Antwort (Response)Ankerlink kopieren

Gibt das aktualisierte Benutzerobjekt zurück. Siehe Fehlerliste für Fehlerantworten.