Invitations

Пригласить пачку людей с одной ролью

До 100 почт с одной ролью. Для каждой почты находится действующая карточка «Команды» с этой рабочей почтой или заводится новая без доступа (имя необязательно: без него карточка временно носит почту и после принятия получает имя, которое человек впишет при регистрации). Затем выпускается приглашение — письмом или, с send_email false, ссылкой в invite_url строки. Строки обрабатываются независимо, ответ 200 называет исход каждой: invited, link, duplicate (та же почта выше в списке) или error с кодом. Почта карточки из уволенных — ошибка invitations.employee_dismissed.

post/api/v1/invitations/batch

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/invitations/batch
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Request body

role_idstring uuid required
send_emailboolean

false — без писем, ссылка в invite_url каждой строки

access_untilstring date nullable

Последний день доступа ГГГГ-ММ-ДД для всей пачки; пусто — бессрочно

affiliation'own' | 'external' | 'guest'

own — свои (умолчание), external — внешние участники, guest — гости-подрядчики от одной организации: новые карточки заводятся с этой принадлежностью, найденные свои помечаются ею. Принятому в штат строка отвечает invitations.employee_hired. Гость места тарифа не занимает и видит только задачи, чаты и папки, куда его позвали

organization_contact_idstring uuid nullable

Контрагент-организация внешних участников и гостей (юрлицо или ИП кабинета); обязателен при affiliation external и guest, иначе 400 invitations.affiliation_invalid

Response

Отчёт по строкам

invitedinteger required
linksinteger required
skippedinteger required
failedinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.