Users

Base path: /v1/users · Auth: Bearer

Method	Path	Purpose
GET	/v1/users	List users (pagination/filter)
POST	/v1/users	Create a user
GET	/v1/users/me	Current profile
PATCH	/v1/users/me	Update your own profile
GET	/v1/users/{userId}	Retrieve a user
PATCH	/v1/users/{userId}	Update a user
DELETE	/v1/users/{userId}	Delete a user

Query (GET /v1/users)

Pagination (page, pageSize, search, sort) plus:

Parameter	Type	Description
status	enum active | inactive | suspended	Filter by status
role	enum admin | user | guest	Filter by role
team	UUID	Filter by team

Body — create (POST /v1/users)

Field	Type	Required	Description
mail	string (email)	✅	Email
first_name	string	✅	First name
last_name	string	✅	Last name
role	enum admin | user | guest	–	Role
teams	UUID[]	–	Team memberships
country	string (2 characters)	–	Country code
locale	string	–	Locale
timezone	integer	–	Timezone offset
languages	string[]	–	Languages
sid	string	–	Custom short ID

Body — update (PATCH /v1/users/{userId} or /me)

All optional: status (active/inactive/suspended), first_name, last_name, avatar, color (#RRGGBB), role, teams, country, locale, timezone, languages, darkmode (auto/light/dark).

Example

curl https://api.eu.liza.app/api/v1/users/me \
  -H "Authorization: Bearer YOUR_TOKEN"

curl "https://api.eu.liza.app/api/v1/users?limit=20&search=anna" \
  -H "Authorization: Bearer YOUR_TOKEN"