Team Members API

Betreut von: Aether365 Team Zielgruppe: Entwickler Umfang: API-Endpunkte für Teammitglieder - Benutzerzugriff verwalten

Autorisierung

Die Team-Member-Endpunkte verwenden rollenbasierte Zugriffskontrolle:

Endpunkt	Berechtigte Rollen
Mitglieder auflisten	Owner, Admin, Member
Mitglied einladen	Owner, Admin
Rolle eines Mitglieds ändern	Owner
Mitglied entfernen	Owner

---

Teammitglieder auflisten

Gibt alle Mitglieder des authentifizierten Tenant-Kontos zurück.

GET /tenants/me/members

Beispielanfrage

curl https://api.aether365.io/tenants/me/members \
  -H "Authorization: Bearer <token>"

Beispielantwort

{
  "success": true,
  "data": [
    {
      "id": "mem_abc123",
      "email": "alice@example.com",
      "status": "active",
      "role": "owner",
      "invitedAt": "2026-01-15T10:00:00Z",
      "joinedAt": "2026-01-15T10:30:00Z"
    },
    {
      "id": "mem_def456",
      "email": "bob@example.com",
      "status": "active",
      "role": "member",
      "invitedAt": "2026-02-01T09:00:00Z",
      "joinedAt": "2026-02-01T11:00:00Z"
    },
    {
      "id": "mem_ghi789",
      "email": "carol@example.com",
      "status": "pending",
      "role": "member",
      "invitedAt": "2026-04-10T08:00:00Z",
      "joinedAt": null
    }
  ]
}

Antwortfelder

Feld	Typ	Beschreibung
id	string	Mitglieder-Kennung
email	string	E-Mail-Adresse des Mitglieds
status	string	active oder pending
role	string	owner, admin oder member
invitedAt	string	ISO 8601-Zeitstempel der Einladung
joinedAt	string oder null	ISO 8601-Zeitstempel der Einladungsannahme

---

Teammitglied einladen

Sendet eine Einladungs-E-Mail an ein neues Teammitglied.

POST /tenants/me/members/invite

Anfragekörper

{
  "email": "newmember@example.com",
  "role": "member"
}

Feld	Typ	Erforderlich	Standard	Beschreibung
email	string	Ja	-	E-Mail-Adresse für die Einladung
role	string	Nein	"member"	"member" oder "admin"

Beispielanfrage

curl -X POST https://api.aether365.io/tenants/me/members/invite \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"email": "newmember@example.com", "role": "member"}'

Beispielantwort

{
  "success": true,
  "data": {
    "id": "mem_xyz999",
    "email": "newmember@example.com",
    "status": "pending",
    "role": "member",
    "invitedAt": "2026-04-12T10:00:00Z",
    "joinedAt": null
  }
}

Fehler

Code	HTTP	Beschreibung
MEMBER_LIMIT_REACHED	429	Mitgliederlimit des Plans erreicht
MEMBER_ALREADY_EXISTS	409	Diese E-Mail-Adresse ist bereits Mitglied oder hat eine offene Einladung
VALIDATION_ERROR	400	Ungültige E-Mail-Adresse

---

Rolle eines Mitglieds ändern

Ändert die Rolle eines bestehenden Teammitglieds.

PATCH /tenants/me/members/{memberId}

WARNING

Nur der Kontoinhaber kann Rollen ändern. Admins können keine Rollen ändern.

Anfragekörper

{
  "role": "admin"
}

Feld	Typ	Erforderlich	Beschreibung
role	string	Ja	Neue Rolle: "member" oder "admin"

Beispielanfrage

curl -X PATCH https://api.aether365.io/tenants/me/members/mem_def456 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"role": "admin"}'

Beispielantwort

{
  "success": true,
  "data": {
    "id": "mem_def456",
    "email": "bob@example.com",
    "status": "active",
    "role": "admin",
    "invitedAt": "2026-02-01T09:00:00Z",
    "joinedAt": "2026-02-01T11:00:00Z"
  }
}

---

Teammitglied entfernen

Entfernt ein Mitglied aus dem Konto. Der Zugriff wird sofort entzogen.

DELETE /tenants/me/members/{memberId}

WARNING

Der Kontoinhaber kann nicht entfernt werden. Um die Inhaberschaft zu übertragen, wenden Sie sich an den Support.

Beispielanfrage

curl -X DELETE https://api.aether365.io/tenants/me/members/mem_def456 \
  -H "Authorization: Bearer <token>"

Beispielantwort

{
  "success": true,
  "data": null
}