Benutzerverwaltung
Jedes Tool rufst du mit POST /api/app-tools und dem Tool-Namen auf. Klapp ein Tool auf, um Eingabefelder, nötige Rechte und eine Beispiel-Anfrage zu sehen. Ob dein API-Key ein Tool nutzen darf, zeigt der Katalog deiner Instanz (App-Tools-API).
Wie die App in der Oberfläche funktioniert, steht in der Hilfe unter Benutzer.
Kein Tool passt zu deiner Eingabe.
Datenobjekte
Die Standard-Aktionen je Datenobjekt: list (suchen und blättern), get (einen Datensatz lesen), create, update und delete. Nicht jedes Objekt bietet alle fünf an.
Personen / Benutzer benutzerverwaltung.person.*
benutzerverwaltung.person.list Lesen Liste/Suche: Personen / Benutzer
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
search | string | nein | Freitextsuche |
filters | object | nein | Feld=Wert-Filter |
limit | integer | nein | |
offset | integer | nein | |
orderBy | string | nein |
{
"name": "benutzerverwaltung.person.list",
"input": {}
} benutzerverwaltung.person.get Lesen Detail: Personen / Benutzer
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | string | ja |
{
"name": "benutzerverwaltung.person.get",
"input": {
"id": "<id>"
}
} Weitere Aktionen
Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.
benutzerverwaltung.onboard Anlegen Bestätigung Legt eine Person an; mit E-Mail zusätzlich Login-Account + Tenant-Mitgliedschaft mit Rollen …
Legt eine Person an; mit E-Mail zusätzlich Login-Account + Tenant-Mitgliedschaft mit Rollen (tenant_roles.slug). invite=false (Default) provisioniert nur, invite=true versendet den Magic-Link. Idempotent auf E-Mail (existierender User wird verlinkt). Admin-Rollen sind gesperrt. Für Bulk-Onboarding je Kunde.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
vorname | string | ja | |
nachname | string | ja | |
email | string | nein | E-Mail für den Login-Account. Ohne E-Mail wird nur eine Person (Stammdaten) angelegt. |
rollen | string[] | nein | Rollen-Slugs (tenant_roles.slug), Mehrfachauswahl. Admin-Rollen werden abgelehnt. |
invite | boolean | nein | true = Magic-Link (Einladung) sofort versenden. Default false = nur Konto anlegen. |
mitLogin | boolean | nein | Login-Account anlegen. Default true wenn E-Mail vorhanden. |
anrede | string | nein | |
titel | string | nein | |
telefon | string | nein | |
mobil | string | nein |
{
"name": "benutzerverwaltung.onboard",
"input": {
"vorname": "<vorname>",
"nachname": "<nachname>"
}
} Als Klartext für KI-Assistenten: diese App, alle Apps und Artikel zur API in einer Datei: /api/llms.txt