API членів команди

Авторизація

Дія	Owner	Admin	Member
Список членів	Так	Так	Так
Запрошення члена	Так	Так	Ні
Зміна ролі	Так	Ні	Ні
Видалення члена	Так	Ні	Ні

---

Список членів команди

Повертає всіх членів автентифікованого облікового запису tenant'у.

GET /tenants/me/members

Приклад запиту

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

Приклад відповіді

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

Поля відповіді

Поле	Тип	Опис
id	string	Ідентифікатор члена команди
email	string	Електронна адреса
status	string	active або pending
role	string	owner, admin або member
invitedAt	string	Часова мітка ISO 8601 запрошення
joinedAt	string або null	Часова мітка ISO 8601 прийняття запрошення

---

Запрошення члена команди

Надсилає лист-запрошення новому члену команди.

POST /tenants/me/members/invite

Тіло запиту

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

Поле	Тип	Обов'язкове	Опис
email	string	Так	Електронна адреса для запрошення
role	string	Ні	admin або member (за замовчуванням: member)

Приклад запиту

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

Приклад відповіді

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

Помилки

Код	HTTP	Опис
MEMBER_LIMIT_REACHED	429	Досягнуто ліміту членів команди для плану
MEMBER_ALREADY_EXISTS	409	Ця адреса вже є членом або має очікуюче запрошення
VALIDATION_ERROR	400	Невалідна електронна адреса

---

Зміна ролі члена

Змінює роль учасника команди. Тільки власник облікового запису може змінювати ролі.

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

Тіло запиту

{
  "role": "admin"
}

Поле	Тип	Обов'язкове	Опис
role	string	Так	admin або member

WARNING

Роль власника облікового запису змінити не можна. Для передачі права власності зверніться до служби підтримки.

Приклад запиту

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

Приклад відповіді

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

---

Видалення члена команди

Видаляє члена з облікового запису. Доступ припиняється негайно.

DELETE /tenants/me/members/{memberId}

WARNING

Видалення власника облікового запису заборонено. Для передачі права власності зверніться до служби підтримки.

Приклад запиту

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

Приклад відповіді

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