API členů týmu

API členů týmu slouží ke správě uživatelského přístupu.

Autorizace

Koncové body pro správu členů týmu používají řízení přístupu na základě rolí:

Koncový bod	Povolené role
Seznam členů	Owner, Admin, Member
Pozvání člena	Owner, Admin
Změna role člena	Owner
Odebrání člena	Owner

---

Seznam členů týmu

Vrací všechny členy autentizovaného účtu tenanta.

GET /tenants/me/members

Příklad požadavku

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

Příklad odpovědi

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

Pole odpovědi

Pole	Typ	Popis
id	string	Identifikátor člena
email	string	E-mailová adresa člena
status	string	active nebo pending
role	string	owner, admin nebo member
invitedAt	string	Časové razítko ISO 8601 pozvánky
joinedAt	string nebo null	Časové razítko ISO 8601 přijetí pozvánky

---

Pozvání člena týmu

Odešle e-mail s pozvánkou novému členovi týmu.

POST /tenants/me/members/invite

Tělo požadavku

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

Pole	Typ	Povinné	Výchozí	Popis
email	string	Ano	-	E-mailová adresa pro pozvánku
role	string	Ne	"member"	"member" nebo "admin"

Příklad požadavku

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

Příklad odpovědi

{
  "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	Dosažen limit členů tarifu
MEMBER_ALREADY_EXISTS	409	Tento e-mail je již členem nebo má nevyřízenou pozvánku
VALIDATION_ERROR	400	Neplatná e-mailová adresa

---

Změna role člena

Změní roli existujícího člena týmu.

PATCH /tenants/me/members/{memberId}

WARNING

Role může měnit pouze vlastník účtu. Administrátoři role měnit nemohou.

Tělo požadavku

{
  "role": "admin"
}

Pole	Typ	Povinné	Popis
role	string	Ano	Nová role: "member" nebo "admin"

Příklad požadavku

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

Příklad odpovědi

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

---

Odebrání člena týmu

Odebere člena z účtu. Okamžitě ztratí přístup.

DELETE /tenants/me/members/{memberId}

WARNING

Odebrání vlastníka účtu není povoleno. Pro převod vlastnictví kontaktujte podporu.

Příklad požadavku

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

Příklad odpovědi

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