Users
Basis-Pfad: /v1/users · Auth: Bearer
| Methode | Pfad | Zweck |
|---|---|---|
GET | /v1/users | Benutzer auflisten (Pagination/Filter) |
POST | /v1/users | Benutzer anlegen |
GET | /v1/users/me | Aktuelles Profil |
PATCH | /v1/users/me | Eigenes Profil ändern |
GET | /v1/users/{userId} | Benutzer abrufen |
PATCH | /v1/users/{userId} | Benutzer ändern |
DELETE | /v1/users/{userId} | Benutzer löschen |
Query (GET /v1/users)
Pagination (page, pageSize, search, sort) plus:
| Parameter | Typ | Beschreibung |
|---|---|---|
status | enum active | inactive | suspended | nach Status |
role | enum admin | user | guest | nach Rolle |
team | UUID | nach Team |
Body — anlegen (POST /v1/users)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
mail | string (E-Mail) | ✅ | |
first_name | string | ✅ | Vorname |
last_name | string | ✅ | Nachname |
role | enum admin | user | guest | – | Rolle |
teams | UUID[] | – | Team-Mitgliedschaften |
country | string (2 Zeichen) | – | Länder-Code |
locale | string | – | Locale |
timezone | integer | – | Zeitzonen-Offset |
languages | string[] | – | Sprachen |
sid | string | – | eigene Kurz-ID |
Body — ändern (PATCH /v1/users/{userId} oder /me)
Alle optional: status (active/inactive/suspended), first_name, last_name, avatar, color (#RRGGBB), role, teams, country, locale, timezone, languages, darkmode (auto/light/dark).
Beispiel
bash
curl https://api.eu.liza.app/api/v1/users/me \
-H "Authorization: Bearer DEIN_TOKEN"bash
curl "https://api.eu.liza.app/api/v1/users?limit=20&search=anna" \
-H "Authorization: Bearer DEIN_TOKEN"