Почти всё, что вы создаёте в Агентике, принадлежит организации, а не вашему личному пользователю. Организация — это граница арендатора (tenant): агенты, ключи, настройки телефонии и данные использования живут внутри неё, и каждый запрос к API выполняется в контексте той организации, которая у вас сейчас выбрана.

​
Что ограничено организацией

Ваша выбранная организация определяет, что вы видите и с чем можете работать: Запросы, которым нужна организация, но выбранной организации нет, завершаются ошибкой 400 No organization selected. Запросы к ресурсу другой организации ведут себя так, будто ресурса не существует (404): граница организации проверяется при каждом чтении и записи.

​
Как у вас появляется организация

При первом входе Агентика создаёт для вас одну организацию, добавляет вас в неё и делает её выбранной. Создавать организацию вручную не нужно.
Сейчас в продукте нет механизма приглашений — ни в интерфейсе, ни в API нет способа добавить другого пользователя в вашу организацию. На практике это значит, что вы состоите ровно в одной организации, а дополнительные членства появляются только если их заведёт оператор. Переключатель ниже уже рассчитан на несколько организаций и заработает сам, как только их станет больше одной.

​
Переключение организаций

Переключатель организаций находится в боковой панели. Он скрыт, пока вы состоите менее чем в двух организациях — при единственном членстве переключать нечего. Когда вы выбираете другую организацию:
  1. Переключатель вызывает PATCH /api/v1/user/selected-organization с ID организации.
  2. Сервер проверяет, что вы действительно её участник: выбор организации, в которой вас нет, отклоняется с 403 not_a_member.
  3. Выбор сохраняется в вашей учётной записи, и страница перезагружается, чтобы все запросы, привязанные к организации, выполнились заново уже в новой организации.
Ваш явный выбор сохраняется между сессиями. Агентика сбрасывает его, только если текущий выбор перестал быть действительным членством — тогда вы возвращаетесь в организацию, созданную для вас при регистрации. Тот же список можно получить программно:
Поле name — это идентификатор организации у провайдера аутентификации: то же значение возвращается как organization_provider_id в GET /api/v1/organizations/context, который дополнительно сообщает, из какого источника берётся конфигурация моделей организации.

​
Настройки организации

Две настройки хранятся на уровне организации, а не пользователя. Изменить их можно в разделе Настройки → Предпочтения; они же доступны через GET/PUT /api/v1/organizations/preferences.
Поскольку настройки принадлежат организации, все её участники видят один и тот же тестовый номер и один и тот же часовой пояс отчётов — переключение организации меняет оба значения.