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

Доступ

personnel:promote для повышения, personnel:demote для понижения, personnel:remove для снятия.
string
required
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».

Особенности

Сначала откройте метод подготовки. Перед выполнением операции возьмите revision из его ответа и передайте её как expected_revision. Для повышения и понижения передайте ровно три значения в recommendations. Допустимые ответы: yes, no, not_sure. Для снятия укажите ended_on и передайте пустые recommendations и evidence_cases. Если передаёте attachment_ids, сначала загрузите материалы. При добавлении в ЧС также требуется personnel:blacklist_create.

Параметры

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

Тело запроса

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

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

HTTP 200. Запрос выполнен успешно.
string
Партнёрский метод работает в серверном контексте. Оставьте поле пустым или не передавайте.
string
required
Выполненное действие: promotion — повышение, demotion — понижение, removal — снятие. Допустимые значения promotion, demotion, removal.
string
required
Код должности. Используйте значение из списка доступных должностей.
boolean
required
Есть ли у сотрудника зарегистрированный аккаунт CRM.
string
Идентификатор сервера CRM (UUID). Сервер должен входить в выданный боту доступ.Формат uuid.
string
required
Идентификатор записи состава, на основании которой выполняется действие.Формат uuid.
string
required
Текущее состояние записи. Допустимые значения active, inactive, removed.
string
required
Идентификатор сотрудника в CRM, в том числе незарегистрированного участника состава (UUID).Формат uuid.
string | null
required
Идентификатор зарегистрированного пользователя CRM. Null, если аккаунт ещё не зарегистрирован.
integer
required
Версия записи. Диапазон от 0 до 9007199254740991.

Ошибки

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

Пример

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