Team Members API

Onderhouden door: Aether365 Team Doelgroep: Ontwikkelaars Scope: Team Members API endpoints - gebruikerstoegang beheren

Autorisatie

De Team Members-endpoints maken gebruik van rolgebaseerde toegangscontrole:

Endpoint	Toegestane rollen
Leden ophalen	Owner, Admin, Member
Lid uitnodigen	Owner, Admin
Rol van een lid wijzigen	Owner
Lid verwijderen	Owner

---

Teamleden ophalen

Retourneert alle leden van het geauthenticeerde tenantaccount.

GET /tenants/me/members

Voorbeeldverzoek

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

Voorbeeldresponse

{
  "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
    }
  ]
}

Responsevelden

Veld	Type	Beschrijving
id	string	Lididentificatie
email	string	E-mailadres van het lid
status	string	active of pending
role	string	owner, admin of member
invitedAt	string	ISO 8601-tijdstempel van de uitnodiging
joinedAt	string of null	ISO 8601-tijdstempel wanneer de uitnodiging is geaccepteerd

---

Een teamlid uitnodigen

Verstuurt een uitnodigings-e-mail naar een nieuw teamlid.

POST /tenants/me/members/invite

Verzoekbody

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

Veld	Type	Vereist	Standaard	Beschrijving
email	string	Ja	-	E-mailadres om uit te nodigen
role	string	Nee	"member"	"member" of "admin"

Voorbeeldverzoek

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"}'

Voorbeeldresponse

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

Fouten

Code	HTTP	Beschrijving
MEMBER_LIMIT_REACHED	429	Ledenlimiet van het abonnement bereikt
MEMBER_ALREADY_EXISTS	409	Dit e-mailadres is al een lid of heeft een openstaande uitnodiging
VALIDATION_ERROR	400	Ongeldig e-mailadres

---

Rol van een teamlid wijzigen

Wijzigt de rol van een bestaand teamlid.

PATCH /tenants/me/members/{memberId}

WARNING

Alleen de accounteigenaar kan rollen wijzigen. Admins kunnen geen rollen wijzigen.

Verzoekbody

{
  "role": "admin"
}

Veld	Type	Vereist	Beschrijving
role	string	Ja	Nieuwe rol: "member" of "admin"

Voorbeeldverzoek

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

Voorbeeldresponse

{
  "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"
  }
}

---

Een teamlid verwijderen

Verwijdert een lid uit het account. Het lid verliest onmiddellijk de toegang.

DELETE /tenants/me/members/{memberId}

WARNING

Het verwijderen van de accounteigenaar is niet toegestaan. Neem contact op met de klantenservice om het eigenaarschap over te dragen.

Voorbeeldverzoek

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

Voorbeeldresponse

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