users

5 Funktionen in dieser Kategorie.

users.list GET /api/admin/users

Alle Benutzer auflisten

Hilfe

Listet alle lokalen und LDAP-Benutzer mit Status, Rolle und Auth-Quelle. Passwort-Hashes werden nicht zurueckgegeben (list_safe).

Beispiel-Prompts

Zeige alle Benutzer
Wer sind die Admins?
Welche Benutzer sind gesperrt?

raw_response: Ja

users.create POST /api/admin/users

Neuen lokalen Benutzer erstellen

Hilfe

Erstellt einen neuen lokalen Benutzer. LDAP-Benutzer werden ueber die LDAP-Integration importiert, nicht hier erstellt. Benutzername mind. 2 Zeichen, Passwort mind. 8 Zeichen.

Parameter

Name	Typ	Required	Default	Beschreibung
`username`	string	Ja	—	Benutzername (mind. 2 Zeichen)
`password`	string	Ja	—	Passwort (mind. 8 Zeichen)
`vorname`	string	Nein	—	Vorname
`nachname`	string	Nein	—	Nachname
`email`	string	Nein	—	E-Mail-Adresse
`is_admin`	boolean	Nein	—	Admin-Rolle (Default: false)

Beispiel-Prompts

Erstelle Benutzer testuser mit Passwort abc12345
Neuen Admin-Account anlegen: admin2, Passwort geheim123

Changelog

Area: users | Action: create

raw_response: Ja | PK-Param: username

users.update PUT /api/admin/users/{user_id}

Benutzer aktualisieren

Hilfe

Aktualisiert Benutzerdaten. Nur uebergebene Felder werden geaendert (Partial Update). Bei Deaktivierung (is_active=false) werden ALLE aktiven Sessions des Benutzers sofort invalidiert. Selbst-Deaktivierung ist nicht erlaubt.

Parameter

Name	Typ	Required	Default	Beschreibung
`user_id`	integer	Ja	—	Benutzer-ID
`vorname`	string	Nein	—	Vorname
`nachname`	string	Nein	—	Nachname
`email`	string	Nein	—	E-Mail-Adresse
`is_admin`	boolean	Nein	—	Admin-Rolle
`is_active`	boolean	Nein	—	Aktiv-Status
`password`	string	Nein	—	Neues Passwort (mind. 8 Zeichen)

Beispiel-Prompts

Mache Benutzer 5 zum Admin
Deaktiviere Benutzer 3
Aendere die E-Mail von Benutzer 7

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: benutzer {user_id} aktualisieren

Changelog

Area: users | Action: update

raw_response: Ja | PK-Param: user_id

users.delete DELETE /api/admin/users/{user_id}

Benutzer loeschen

Hilfe

Loescht einen Benutzer und alle zugehoerigen Sessions (Cascade). Der aktuelle Admin kann sich nicht selbst loeschen.

Parameter

Name	Typ	Required	Default	Beschreibung
`user_id`	integer	Ja	—	Benutzer-ID

Beispiel-Prompts

Loesche Benutzer 5
Entferne den Account von testuser

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: benutzer {user_id} loeschen

Changelog

Area: users | Action: delete

raw_response: Ja | PK-Param: user_id

users.reset_password Chat-only

Benutzer-Passwort zuruecksetzen (Admin-Override)

Hilfe

Setzt das Passwort eines Benutzers ohne das alte Passwort zu kennen. Dies ist ein Admin-Override — der regulaere PUT /api/auth/password Endpunkt erfordert old_password (Self-Service). Neues Passwort mind. 8 Zeichen.

Parameter

Name	Typ	Required	Default	Beschreibung
`user_id`	integer	Ja	—	Benutzer-ID
`new_password`	string	Ja	—	Neues Passwort (mind. 8 Zeichen)

Beispiel-Prompts

Setze das Passwort von Benutzer 5 auf Neu12345
Passwort-Reset fuer testuser

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: passwort fuer benutzer {user_id} zuruecksetzen

Changelog

Area: users | Action: update

raw_response: Nein | PK-Param: user_id

Chat-only (kein HTTP-Mapping)