API Membres d'équipe

Maintenu par : Aether365 Team Public : Développeurs Périmètre : Endpoints de l'API Team Members - gestion des accès utilisateurs

Autorisation

Les endpoints Team Members utilisent un contrôle d'accès basé sur les rôles :

Endpoint	Rôles autorisés
Lister les membres	Owner, Admin, Member
Inviter un membre	Owner, Admin
Modifier le rôle d'un membre	Owner
Retirer un membre	Owner

---

Lister les membres de l'équipe

Renvoie tous les membres du compte tenant authentifié.

GET /tenants/me/members

Exemple de requête

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

Exemple de réponse

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

Champs de la réponse

Champ	Type	Description
id	string	Identifiant du membre
email	string	Adresse e-mail du membre
status	string	active ou pending
role	string	owner, admin ou member
invitedAt	string	Horodatage ISO 8601 de l'invitation
joinedAt	string ou null	Horodatage ISO 8601 de l'acceptation de l'invitation

---

Inviter un membre de l'équipe

Envoie un e-mail d'invitation à un nouveau membre de l'équipe.

POST /tenants/me/members/invite

Corps de la requête

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

Champ	Type	Requis	Par défaut	Description
email	string	Oui	-	Adresse e-mail à inviter
role	string	Non	"member"	"member" ou "admin"

Exemple de requête

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

Exemple de réponse

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

Erreurs

Code	HTTP	Description
MEMBER_LIMIT_REACHED	429	Limite de membres du plan atteinte
MEMBER_ALREADY_EXISTS	409	Cet e-mail est déjà membre ou a une invitation en attente
VALIDATION_ERROR	400	Adresse e-mail invalide

---

Modifier le rôle d'un membre

Modifie le rôle d'un membre existant de l'équipe.

PATCH /tenants/me/members/{memberId}

WARNING

Seul le propriétaire du compte peut modifier les rôles. Les Admins ne peuvent pas modifier les rôles.

Corps de la requête

{
  "role": "admin"
}

Champ	Type	Requis	Description
role	string	Oui	Nouveau rôle : "member" ou "admin"

Exemple de requête

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

Exemple de réponse

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

---

Retirer un membre de l'équipe

Retire un membre du compte. Son accès est immédiatement révoqué.

DELETE /tenants/me/members/{memberId}

WARNING

Il n'est pas possible de retirer le propriétaire du compte. Pour transférer la propriété, contactez le support.

Exemple de requête

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

Exemple de réponse

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