API členov tímu

Autorizácia

Akcia	Owner	Admin	Member
Zoznam členov	Áno	Áno	Áno
Pozvanie člena	Áno	Áno	Nie
Zmena roly	Áno	Nie	Nie
Odstránenie člena	Áno	Nie	Nie

---

Zoznam členov tímu

Vráti všetkých členov autentifikovaného účtu tenanta.

GET /tenants/me/members

Príklad požiadavky

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

Príklad odpovede

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

Polia odpovede

Pole	Typ	Popis
id	string	Identifikátor člena
email	string	E-mailová adresa člena
status	string	active alebo pending
role	string	owner, admin alebo member
invitedAt	string	Časová pečiatka ISO 8601 pozvánky
joinedAt	string alebo null	Časová pečiatka ISO 8601 prijatia pozvánky

---

Pozvanie člena tímu

Odošle pozývací e-mail novému členovi tímu.

POST /tenants/me/members/invite

Telo požiadavky

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

Pole	Typ	Povinné	Popis
email	string	Áno	E-mailová adresa na pozvanie
role	string	Nie	admin alebo member (predvolené: member)

Príklad požiadavky

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

Príklad odpovede

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

Chyby

Kód	HTTP	Popis
MEMBER_LIMIT_REACHED	429	Dosiahnutý limit členov pre daný plán
MEMBER_ALREADY_EXISTS	409	Tento e-mail je už členom alebo má čakajúcu pozvánku
VALIDATION_ERROR	400	Neplatná e-mailová adresa

---

Zmena roly člena

Zmení rolu člena tímu. Roly môže meniť iba vlastník účtu.

PATCH /tenants/me/members/{memberId}/role

Telo požiadavky

{
  "role": "admin"
}

Pole	Typ	Povinné	Popis
role	string	Áno	admin alebo member

WARNING

Rolu vlastníka účtu nie je možné zmeniť. Pre prevod vlastníctva kontaktujte podporu.

Príklad požiadavky

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

Príklad odpovede

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

---

Odstránenie člena tímu

Odstráni člena z účtu. Okamžite stráca prístup.

DELETE /tenants/me/members/{memberId}

WARNING

Odstránenie vlastníka účtu nie je povolené. Pre prevod vlastníctva kontaktujte podporu.

Príklad požiadavky

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

Príklad odpovede

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