Meeskonnaliikmete API

Autoriseerimine

Meeskonnaliikmete lõpp-punktid kasutavad rollipõhist juurdepääsukontrolli:

Lõpp-punkt	Lubatud rollid
Liikmete loetelu	Owner, Admin, Member
Liikme kutsumine	Owner, Admin
Liikme rolli muutmine	Owner
Liikme eemaldamine	Owner

---

Meeskonnaliikmete loetelu

Tagastab kõik autenditud halduskeskkonna konto liikmed.

GET /tenants/me/members

Näidispäring

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

Näidisvastus

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

Vastuse väljad

Väli	Tüüp	Kirjeldus
id	string	Liikme identifikaator
email	string	Liikme e-posti aadress
status	string	active või pending
role	string	owner, admin või member
invitedAt	string	Kutse ISO 8601 ajatempel
joinedAt	string või null	Kutse vastuvõtmise ISO 8601 ajatempel

---

Meeskonnaliikme kutsumine

Saadab uuele meeskonnaliikmele kutsemeili.

POST /tenants/me/members/invite

Päringu keha

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

Väli	Tüüp	Nõutav	Vaikeväärtus	Kirjeldus
email	string	Jah	-	Kutse e-posti aadress
role	string	Ei	"member"	"member" või "admin"

Näidispäring

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

Näidisvastus

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

Vead

Kood	HTTP	Kirjeldus
MEMBER_LIMIT_REACHED	429	Plaani liikmete limiit on täis
MEMBER_ALREADY_EXISTS	409	See e-posti aadress on juba liige või on ootel kutse
VALIDATION_ERROR	400	Vigane e-posti aadress

---

Liikme rolli muutmine

Muudab olemasoleva meeskonnaliikme rolli.

PATCH /tenants/me/members/{memberId}

WARNING

Ainult konto omanik saab rolle muuta. Administraatoritel puudub rollide muutmise õigus.

Päringu keha

{
  "role": "admin"
}

Väli	Tüüp	Nõutav	Kirjeldus
role	string	Jah	Uus roll: "member" või "admin"

Näidispäring

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

Näidisvastus

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

---

Meeskonnaliikme eemaldamine

Eemaldab liikme kontolt. Ta kaotab kohe juurdepääsu.

DELETE /tenants/me/members/{memberId}

WARNING

Konto omanikku ei saa eemaldada. Omandiõiguse üleandmiseks võtke ühendust klienditoega.

Näidispäring

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

Näidisvastus

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