API Membri del team

Maintainer: Aether365 Team Destinatari: Sviluppatori Ambito: Endpoint API Membri del team - gestione degli accessi utente

Autorizzazione

Gli endpoint Team Members utilizzano il controllo degli accessi basato sui ruoli:

Endpoint	Ruoli consentiti
Elencare i membri	Owner, Admin, Member
Invitare un membro	Owner, Admin
Modificare il ruolo di un membro	Owner
Rimuovere un membro	Owner

---

Elencare i membri del team

Restituisce tutti i membri dell'account tenant autenticato.

GET /tenants/me/members

Richiesta di esempio

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

Risposta di esempio

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

Campi della risposta

Campo	Tipo	Descrizione
id	string	Identificativo del membro
email	string	Indirizzo email del membro
status	string	active o pending
role	string	owner, admin o member
invitedAt	string	Timestamp ISO 8601 dell'invito
joinedAt	string o null	Timestamp ISO 8601 di accettazione dell'invito

---

Invitare un membro del team

Invia un'email di invito a un nuovo membro del team.

POST /tenants/me/members/invite

Corpo della richiesta

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

Campo	Tipo	Obbligatorio	Predefinito	Descrizione
email	string	Sì	-	Indirizzo email da invitare
role	string	No	"member"	"member" o "admin"

Richiesta di esempio

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

Risposta di esempio

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

Errori

Codice	HTTP	Descrizione
MEMBER_LIMIT_REACHED	429	Limite membri del piano raggiunto
MEMBER_ALREADY_EXISTS	409	Questa email è già membro o ha un invito in sospeso
VALIDATION_ERROR	400	Indirizzo email non valido

---

Modificare il ruolo di un membro

Modifica il ruolo di un membro del team esistente.

PATCH /tenants/me/members/{memberId}

WARNING

Solo il proprietario dell'account può modificare i ruoli. Gli Admin non possono modificare i ruoli.

Corpo della richiesta

{
  "role": "admin"
}

Campo	Tipo	Obbligatorio	Descrizione
role	string	Sì	Nuovo ruolo: "member" o "admin"

Richiesta di esempio

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

Risposta di esempio

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

---

Rimuovere un membro del team

Rimuove un membro dall'account. Perde immediatamente l'accesso.

DELETE /tenants/me/members/{memberId}

WARNING

Non è possibile rimuovere il proprietario dell'account. Per trasferire la proprietà, contatta il supporto.

Richiesta di esempio

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

Risposta di esempio

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