Skip to main content
POST
Назначает либо восстанавливает сотрудника на выбранном сервере. Используйте ревизию и данные назначения, полученные при подготовке. Обязателен заголовок Idempotency-Key.

Доступ

personnel:appoint для назначения, personnel:restore для восстановления.
string
required
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».

Особенности

Сначала откройте метод подготовки. Перед выполнением операции возьмите revision из его ответа и передайте её как expected_revision.

Параметры

string
required
Уникальный ключ действия: от 16 до 128 печатных ASCII-символов без пробелов. При повторе того же запроса используйте тот же ключ. Для нового действия создайте новый. До 128 символов.

Тело запроса

Передайте JSON с заголовком Content-Type: application/json.
object
required
object
required
Модератор, который инициировал действие через бота. CRM определяет его аккаунт по привязанному внешнему ID и проверяет полномочия.

Успешный ответ

HTTP 200. Запрос выполнен успешно.
string
required
Идентификатор назначения сотрудника.Формат uuid.
string
required
Код выполняемой операции. Допустимые значения указаны в схеме.
boolean
required
Есть ли у сотрудника зарегистрированный аккаунт CRM.
string
required
Идентификатор сервера CRM (UUID). Сервер должен входить в выданный боту доступ.Формат uuid.
string | null
required
Идентификатор зарегистрированного пользователя CRM. Null, если аккаунт ещё не зарегистрирован.
integer
required
Версия записи.

Ошибки

См. формат ошибок и правила повторов.

Пример

Подставьте свои ID, а для изменения используйте отдельный ключ операции и ревизию из CRM.