Benutzer-API

Basis-URL

https://api.uslimato.com/v1

Benötigte Berechtigung: users:read

---

Benutzer auflisten

GET /users

Gibt alle Benutzer Ihrer Organisation zurück.

Query-Parameter:

Parameter	Typ	Beschreibung
q	string	Suche nach Anzeigename oder E-Mail

Antwort:

{
  "data": [
    {
      "id": "clx...",
      "email": "[email protected]",
      "display_name": "Jane Doe",
      "role": "technician",
      "is_active": true,
      "last_login_at": "2024-11-20T09:15:00Z",
      "created_at": "2024-01-10T08:00:00Z"
    }
  ]
}

---

Benutzer abrufen

GET /users/:id

Gibt einen einzelnen Benutzer anhand seiner ID zurück.

---

Benutzerrollen

Wert	Beschreibung
viewer	Nur-Lese-Zugriff
helpdesk	Assets ansehen, Prozessinstanzen erstellen
technician	Assets erstellen und bearbeiten, Prozesse verwalten
admin	Vollzugriff inkl. Benutzer- und Einstellungsverwaltung

---

Hinweise

• Die Benutzer-API ist schreibgeschützt. Die Benutzerbereitstellung erfolgt über HGE ID und die Tenant-Admin-Oberfläche.
• Es werden nur Benutzer Ihrer Organisation zurückgegeben — die Tenant-Isolation wird auf API-Ebene durchgesetzt.
• Inaktive Benutzer (is_active: false) sind in der Listenantwort enthalten.