Nutzer

Nutzer repräsentieren die Personen in deiner Organisation. Du kannst neue Mitglieder einladen, ihre Profile aktualisieren und ihre Rollen verwalten.

Nutzer auflisten

GET /api/v1/users

Berechtigung erforderlich: members:view

Gibt alle Nutzer der Organisation zurück.

Beispiel-Response

[
  {
    "id": "usr_abc123",
    "email": "[email protected]",
    "name": "Alex Smith",
    "role": "ADMIN",
    "createdAt": "2025-01-15T10:00:00Z"
  },
  {
    "id": "usr_def456",
    "email": "[email protected]",
    "name": "Jamie Lee",
    "role": "TEAM_MEMBER",
    "createdAt": "2025-02-01T09:00:00Z"
  }
]

Nutzer erstellen (einladen)

POST /api/v1/users

Berechtigung erforderlich: members:invite

Lade einen neuen Nutzer in die Organisation ein. Er erhält eine E-Mail mit Anmeldedaten.

Request Body

Beispiel-Request

{
  "email": "[email protected]",
  "name": "Jamie Lee",
  "role": "TEAM_MEMBER",
  "password": "SecureP@ss123"
}

Nutzer abrufen

GET /api/v1/users/{userId}

Berechtigung erforderlich: members:view

Gibt Details zu einem bestimmten Nutzer zurück.

Nutzer aktualisieren

PATCH /api/v1/users/{userId}

Berechtigung erforderlich: members:edit

Request Body

Nutzerrolle aktualisieren

PATCH /api/v1/users/{userId}/role

Berechtigung erforderlich: members:edit

Ändert die Organisationsrolle eines Nutzers.

Request Body