Список всех приглашений
Возвращает список всех приглашений в организации.
Метод | Путь |
---|
GET | /v1/organizations/{organizationId}/invitations |
Запрос
Параметры пути
Название | Тип | Описание |
---|
organizationId | uuid | ID запрашиваемой организации. |
Ответ
Схема ответа
Название | Тип | Описание |
---|
role | string | Роль участника в организации. |
id | uuid | Уникальный ID приглашения. |
email | email | Email приглашенного пользователя. Только пользователь с этим email может присоединиться, используя приглашение. Email хранится в нижнем регистре. |
createdAt | date-time | Время создания приглашения. ISO-8601. |
expireAt | date-time | Время истечения срока действия приглашения. ISO-8601. |
Пример ответа
Создать приглашение
Создает приглашение в организацию.
Метод | Путь |
---|
POST | /v1/organizations/{organizationId}/invitations |
Запрос
Параметры пути
Название | Тип | Описание |
---|
organizationId | uuid | ID организации, в которую приглашается пользователь. |
Параметры тела
Название | Тип | Описание |
---|
email | string | Email приглашенного пользователя. Только пользователь с этим email может присоединиться, используя приглашение. Email хранится в нижнем регистре. |
role | string | Роль участника в организации. |
Ответ
Схема ответа
Название | Тип | Описание |
---|
role | string | Роль участника в организации. |
id | uuid | Уникальный ID приглашения. |
email | email | Email приглашенного пользователя. Только пользователь с этим email может присоединиться, используя приглашение. Email хранится в нижнем регистре. |
createdAt | date-time | Время создания приглашения. ISO-8601. |
expireAt | date-time | Время истечения срока действия приглашения. ISO-8601. |
Пример ответа
Получить детали приглашения
Возвращает детали для одного приглашения в организацию.
Метод | Путь |
---|
GET | /v1/organizations/{organizationId}/invitations/{invitationId} |
Запрос
Параметры пути
Название | Тип | Описание |
---|
organizationId | uuid | ID запрашиваемой организации. |
invitationId | uuid | ID запрашиваемого приглашения. |
Ответ
Схема ответа
Название | Тип | Описание |
---|
role | string | Роль участника в организации. |
id | uuid | Уникальный ID приглашения. |
email | email | Email приглашенного пользователя. Только пользователь с этим email может присоединиться, используя приглашение. Email хранится в нижнем регистре. |
createdAt | date-time | Время создания приглашения. ISO-8601. |
expireAt | date-time | Время истечения срока действия приглашения. ISO-8601. |
Пример ответа
Удалить приглашение организации
Удаляет одно приглашение в организацию.
Метод | Путь |
---|
DELETE | /v1/organizations/{organizationId}/invitations/{invitationId} |
Запрос
Параметры пути
Название | Тип | Описание |
---|
organizationId | uuid | ID организации, у которой есть приглашение. |
invitationId | uuid | ID запрашиваемого приглашения. |