Organisationen

Organisationen auflisten

GET /api/v1/organizations

Gibt alle Organisationen zurück, zu denen der authentifizierte Benutzer gehört.

Antwort

{
  "data": [
    {
      "id": "org_uuid",
      "name": "Acme Inc.",
      "role": "ADMIN",
      "member_count": 12
    }
  ]
}

Rollenwerte

Rolle	Beschreibung
OWNER	Voller Zugriff, kann die Organisation übertragen oder löschen
ADMIN	Mitglieder, Ordner und alle Aufzeichnungen verwalten
EDITOR	Eigene Aufzeichnungen erstellen und verwalten
VIEWER	Nur-Lesezugriff

---

Ordner auflisten

GET /api/v1/organizations/:id/folders

Gibt alle aktiven Ordner in der Organisation zurück. Der authentifizierte Benutzer muss ein Mitglied sein.

Antwort

{
  "data": [
    {
      "id": "folder_uuid",
      "name": "Product team"
    }
  ]
}

---

Mitglieder auflisten

GET /api/v1/organizations/:id/members

Gibt alle Mitglieder der Organisation zurück. Der authentifizierte Benutzer muss ein Mitglied sein.

Antwort

{
  "data": [
    {
      "id": "user_uuid",
      "email": "alice@example.com",
      "name": "Alice",
      "role": "EDITOR"
    }
  ]
}

Fehlercodes

Code	HTTP Status	Bedeutung
FORBIDDEN	403	Der Benutzer ist kein Mitglied dieser Organisation
ORGANIZATION_NOT_FOUND	404	Organisation existiert nicht