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

Авторизацiя

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

---

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

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

GET /tenants/me/members

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

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

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

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

Поля вiдповiдi

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

---

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

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

POST /tenants/me/members/invite

Тiло запиту

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

Поле	Тип	Обов'язкове	Опис
email	string	Так	Електронна адреса для запрошення
role	string	Нi	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"}'

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

{
  "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	Досягнуто лiмiту членiв команди для плану
MEMBER_ALREADY_EXISTS	409	Ця адреса вже є членом або має очiкуюче запрошення
VALIDATION_ERROR	400	Невалiдна електронна адреса

---

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

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

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

Тiло запиту

{
  "role": "admin"
}

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

WARNING

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

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

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

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

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

---

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

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

DELETE /tenants/me/members/{memberId}

WARNING

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

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

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

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

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