Управление участниками

Team workspace поддерживает до 10 участников (Pro план). Управление участниками осуществляется через email-приглашения с magic link.

Приглашение участников

Приглашение новых участников выполняется через отправку email с magic link:

Откройте настройки workspace

/{workspace-slug}/settings/members
Нажмите “Invite Member”
Введите email

Email, на который будет отправлено приглашение
Выберите роль

Admin, Developer, Member, Viewer, Billing или одну из ваших кастомных ролей (доступно на плане Enterprise)
Отправьте приглашение

Система отправит email с magic link для присоединения

Параметры приглашения

token — уникальный токен приглашения
expiresAt — срок действия 7 дней с момента создания
email — email получателя приглашения
role — назначенная роль (ADMIN, DEVELOPER, MEMBER, VIEWER или BILLING)

Роли и права

В workspace доступны шесть встроенных ролей плюс кастомные роли (на плане Enterprise).

Owner

Создатель workspace с полным контролем:

Всё, что доступно Admin
Удаление workspace
Передача ownership другому участнику
Управление API-ключами

Admin

Администратор без права удалить workspace и изменить ownership:

Всё, что доступно Developer
Приглашение и удаление участников
Изменение ролей других участников
Создание и редактирование Custom Roles и Access Groups
Управление биллингом и API-ключами

Developer

Разработчик с правами на выпуск кода и настройку проектов, но без прав на состав команды и биллинг:

Разворачивать деплои, откатывать и создавать share-links
Создавать и редактировать проекты, переменные окружения, домены
Просматривать состав команды (без изменений)

Developer подходит подрядчикам и внутренним инженерам, которым нужен технический доступ, но не финансовая или командная ответственность.

Member

Базовый участник с read-only доступом к продуктовой части:

Просмотр всех проектов, деплоев и логов
Просмотр переменных окружения (без значений секретов)
Просмотр доменов
Просмотр списка участников и биллинга (без управления)

Изменение конфигурации, создание деплоев и управление env vars Member недоступны.

Viewer

Самая узкая роль для чтения — без доступа к биллингу. Подходит для stakeholder’ов (менеджеры, сторонние аудиторы), которым нужно видеть состояние продукта, но не финансовые данные:

Просмотр проектов, деплоев, логов, env vars (без секретов), доменов, команды
Нет доступа к биллингу

Billing

Роль для финансовых сотрудников — доступ только к биллингу:

Просмотр биллинг-профиля, инвойсов, подписки и Usage
Оплата инвойсов, смена тарифа, привязка и смена платёжного метода
Редактирование биллинг-реквизитов (реквизиты плательщика, ИНН)

Участник с ролью Billing не видит и не может менять проекты, деплои, переменные окружения, домены и состав команды.

Custom Roles (Enterprise)

На плане Enterprise можно создать собственные роли на базе Developer / Member / Viewer с дополнительным набором прав. Например, «Release Manager» = Member + право деплоить только на production.

Кастомные роли управляются в разделе Settings → Роли (/{workspace-slug}/settings/roles).

Access Groups (Pro, Enterprise)

Если нужно дать участнику доступ только к части проектов (подрядчик работает над одним проектом, маркетинг-команда видит три из десяти) — используйте Access Groups вместо того, чтобы выдавать рабочую workspace-роль:

Создайте группу в Settings → Access Groups
Укажите её роль (Developer, Member, Viewer или кастомная)
Добавьте проекты, которые группа покрывает
Добавьте участников

Участник видит только проекты своей группы (если у него нет отдельной workspace-роли). Права складываются: итог = права workspace-роли ∪ права каждой группы для данного проекта.

Пример: подрядчик приглашён как Viewer на workspace и состоит в Access Group «Project X» с ролью Developer. Во всех проектах он видит только чтение, а на Project X может деплоить.

Лимиты: Pro — 10 групп, Enterprise — 100 групп.

Принятие приглашения

Приглашение принимается через magic link:

/invite/:token

Процесс принятия

Получите email с приглашением
Перейдите по magic link

Ссылка ведёт на /invite/:token
Авторизуйтесь или создайте аккаунт

Если у вас ещё нет аккаунта — потребуется регистрация
Подтвердите присоединение

После подтверждения вы становитесь участником workspace

Обработка существующих участников

Если пользователь уже состоит в workspace — приглашение отклоняется
Если email уже связан с аккаунтом — присоединение происходит автоматически после перехода по ссылке

Управление через API

API endpoints для управления участниками и приглашениями находятся под /v1.

Для session-запросов передавайте workspace slug через X-Workspace или ?workspace=. Workspace API key уже привязан к workspace, поэтому отдельный slug для него не нужен.

Участники

# Получить список участников
GET /v1/workspace-members
X-Workspace: my-workspace

# Изменить роль участника (встроенная роль)
PATCH /v1/workspace-members/{memberId}/role
Content-Type: application/json

{
  "role": "ADMIN" | "DEVELOPER" | "MEMBER" | "VIEWER" | "BILLING"
}

# …или назначить кастомную роль
PATCH /v1/workspace-members/{memberId}/role
Content-Type: application/json

{
  "customRoleId": "<custom-role-uuid>"
}

# Удалить участника
DELETE /v1/workspace-members/{memberId}

Приглашения

# Создать приглашение на встроенную роль
POST /v1/workspace-members/invite
Content-Type: application/json

{
  "email": "user@example.com",
  "role": "ADMIN" | "DEVELOPER" | "MEMBER" | "VIEWER" | "BILLING"
}

# …или пригласить на кастомную роль
POST /v1/workspace-members/invite
Content-Type: application/json

{
  "email": "user@example.com",
  "customRoleId": "<custom-role-uuid>"
}

# Pending invitations возвращаются вместе со списком участников
GET /v1/workspace-members

# Отменить приглашение
DELETE /v1/workspace-members/invitations/{invitationId}

# Получить информацию о приглашении (для страницы принятия)
GET /v1/invitations/{token}

# Принять приглашение (для получателя)
POST /v1/invitations/{token}/accept

Права доступа к API

Endpoint	OWNER	ADMIN	MEMBER	BILLING
`GET /workspace-members`	Да	Да	Да	Нет
`PATCH /workspace-members/{memberId}/role`	Да	Да	Нет	Нет
`DELETE /workspace-members/{memberId}`	Да	Да	Нет	Нет
`POST /workspace-members/invite`	Да	Да	Нет	Нет
`DELETE /workspace-members/invitations/{invitationId}`	Да	Да	Нет	Нет
`POST /invitations/{token}/accept`	Да	Да	Да	Да

API Keys в Team

Workspace-scoped API ключи позволяют автоматизировать операции от имени workspace.

Создание API Key

Откройте Team Settings

/{workspace-slug}/settings/members
Перейдите в раздел “API Keys”
Нажмите “Create API Key”
Укажите название и разрешения
Сохраните ключ

Ключ отображается только один раз при создании

Управление ключами

OWNER и ADMIN — могут создавать, просматривать и отзывать все ключи workspace
MEMBER — может создавать и управлять только собственными ключами
BILLING — не имеет доступа к API ключам

Использование API Key

Authorization: Bearer <workspace-api-key>

API Key наследует права роли, с которой он был создан. Например, ключ созданный с правами ADMIN может управлять участниками.

Лимиты по плану

Лимит	Hobby	Pro	Enterprise
Участников в workspace	1	10	100+
Access Groups	—	10	100
Кастомных ролей	—	—	10
Аудит-лог UI	—	—	Да

Hobby — это всегда solo-workspace (только Owner). Для команды перейдите на Pro. Enterprise добавляет кастомные роли и аудит.

При достижении лимита приглашение новых участников невозможно. Удалите существующего участника или обратитесь к нам за расширением.

Удаление участников

Откройте /{workspace-slug}/settings/members
Найдите участника в списке
Нажмите иконку удаления
Подтвердите

Изменение роли

Откройте /{workspace-slug}/settings/members
Найдите участника
Кликните на текущую роль
Выберите новую роль

Ограничения:

Owner не может понизить себя
Нельзя создать второго Owner
Member не может изменять роли

Передача Ownership

Owner может передать ownership другому Admin:

Откройте настройки участников
Выберите Admin
Нажмите “Transfer Ownership”
Подтвердите с вводом slug

После передачи:

Бывший Owner становится Admin
Новый Owner получает полные права

Доступ к проектам

По умолчанию участник видит проекты в соответствии со своей workspace-ролью. Access Group может расширить права на конкретные проекты (например, дать Viewer возможность деплоить в «Project X»), но не может их отнять.

Действие	Owner	Admin	Developer	Member	Viewer	Billing
Просмотр проектов	Да	Да	Да	Да	Да	Нет
Создание проектов	Да	Да	Да	Нет	Нет	Нет
Настройки проекта	Да	Да	Да	Нет	Нет	Нет
Удаление проекта	Да	Да	Нет	Нет	Нет	Нет
Деплой	Да	Да	Да	Нет	Нет	Нет
Rollback	Да	Да	Да	Нет	Нет	Нет
Просмотр env vars	Да	Да	Да	Да	Да	Нет
Правка env vars	Да	Да	Да	Нет	Нет	Нет
Команда: приглашения	Да	Да	Нет	Нет	Нет	Нет
Просмотр биллинга	Да	Да	Нет	Да	Нет	Да
Оплата, смена тарифа	Да	Да	Нет	Нет	Нет	Да

Эффективные права

Если непонятно, почему участник видит или не видит что-то — откройте меню у него в списке участников и выберите «Эффективные права». Платформа покажет итоговый набор разрешений и все источники (workspace-роль, кастомная роль, Access Groups).

Уведомления участников

Участники получают уведомления о:

Деплоях своих проектов
Ошибках сборки
Проблемах с доменами (OWNER / ADMIN)
Биллинге (OWNER, ADMIN и BILLING — инвойсы, неуспешные автосписания, просрочки)
Новых приглашениях в workspace (email)

→ Настройки уведомлений

Выход из Workspace

Участник может покинуть workspace самостоятельно:

Откройте Team Switcher
Наведите на workspace
Нажмите “Leave”
Подтвердите