> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Повысить, понизить или снять сотрудника

> Выполняет выбранное кадровое действие от имени указанного модератора.

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

## Доступ

`personnel:promote` для повышения, `personnel:demote` для понижения, `personnel:remove` для снятия.

**Authorization** `string` *required*

Партнёрский Bearer-токен. Подробнее в разделе [«Авторизация»](https://docs.arzguard.com/cerberus-crm/authentication.md).

## Особенности

Сначала откройте [метод подготовки](https://docs.arzguard.com/cerberus-crm/api/post-personnel-actions-options.md). Перед выполнением операции возьмите `revision` из его ответа и передайте её как `expected_revision`.

Для повышения и понижения передайте ровно три значения в `recommendations`. Допустимые ответы: `yes`, `no`, `not_sure`. Для снятия укажите `ended_on` и передайте пустые `recommendations` и `evidence_cases`. Если передаёте `attachment_ids`, сначала [загрузите материалы](https://docs.arzguard.com/cerberus-crm/api/post-personnel-materials-upload.md). При добавлении в ЧС также требуется `personnel:blacklist_create`.

## Параметры

**Idempotency-Key** `string` *required*

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

### Тело запроса

Передайте JSON с заголовком `Content-Type: application/json`.

**action** `object` *required*

**Поля**

**attachment\_ids** `string[] | null` *required*

ID загруженных материалов кадрового снятия. Используйте загрузки для тех же бота, модератора, сотрудника и сервера. Требуется personnel:materials\_write. До 5 элементов.

**blacklist** `object`

Параметры занесения в чёрный список при снятии сотрудника.

**Поля**

**attachment\_ids** `string[] | null`

ID загруженных материалов кадрового снятия. Используйте загрузки для тех же бота, модератора, сотрудника и сервера. Требуется personnel:materials\_write. До 5 элементов.

**duration** `string` *required*

Срок действия записи чёрного списка. Допустимые значения указаны в схеме. Допустимые значения `temporary`, `permanent`.

**evidence\_mode** `string` *required*

Способ указания подтверждающих материалов. Допустимые значения `shared`, `separate`.

**material\_url** `string`

Ссылка на подтверждающие материалы (HTTP или HTTPS). До 2048 символов.

**reason** `string` *required*

Причина действия или записи. До 5000 символов.

**scope** `string` *required*

Область чёрного списка: local — выбранный сервер, global — весь проект. Для global необходимо отдельное глобальное право. Допустимые значения `local`, `global`.

**until\_date** `string`

Дата окончания записи чёрного списка в формате ГГГГ-ММ-ДД.

Формат `date`.

**context** `string`

Партнёрский метод работает в серверном контексте. Оставьте поле пустым или не передавайте.

**ended\_on** `string`

Дата снятия в формате ГГГГ-ММ-ДД. Передаётся при операции removal.

Формат `date`.

**evidence\_cases** `string[] | null` *required*

Примеры и основания для кадрового решения. До 10 элементов.

**expected\_revision** `string` *required*

Ожидаемая ревизия из ответа подготовки действия. При конфликте получите актуальные данные и повторно согласуйте действие. До 64 символов.

**material\_url** `string | null` *required*

Ссылка на подтверждающие материалы (HTTP или HTTPS). До 2048 символов.

**operation** `string` *required*

Кадровое действие: promotion — повышение, demotion — понижение, removal — снятие. Допустимые значения `promotion`, `demotion`, `removal`.

**position\_id** `string`

Код должности. Используйте значение из списка доступных должностей. До 100 символов.

**reason** `string` *required*

Причина действия или записи. До 5000 символов.

**recommendations** `string[] | null` *required*

Три рекомендации для повышения или понижения. Каждое значение: yes — да, no — нет, not\_sure — не уверен. До 3 элементов.

**server\_id** `string | integer`

Уникальный номер сервера из GET /api/partner/v1/servers или UUID сервера. Сервер должен входить в выданный боту доступ.

**target\_id** `string` *required*

Идентификатор сотрудника в CRM, в том числе незарегистрированного участника состава (UUID).

Формат `uuid`.

**moderator** `object` *required*

Модератор, который инициировал действие через бота. CRM определяет его аккаунт по привязанному внешнему ID и проверяет полномочия.

**Поля**

**platform\_user\_id** `string` *required*

ID модератора на выбранной платформе, строкой. Это ID пользователя, а не имя или ID бота. До 20 символов.

**provider** `string` *required*

Платформа модератора: discord — Discord, telegram — Telegram. Допустимые значения `discord`, `telegram`.

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

HTTP `200`. Запрос выполнен успешно.

**context** `string`

Партнёрский метод работает в серверном контексте. Оставьте поле пустым или не передавайте.

**operation** `string` *required*

Выполненное действие: promotion — повышение, demotion — понижение, removal — снятие. Допустимые значения `promotion`, `demotion`, `removal`.

**position\_id** `string` *required*

Код должности. Используйте значение из списка доступных должностей.

**registered** `boolean` *required*

Есть ли у сотрудника зарегистрированный аккаунт CRM.

**server\_id** `string`

Идентификатор сервера CRM (UUID). Сервер должен входить в выданный боту доступ.

Формат `uuid`.

**source\_id** `string` *required*

Идентификатор записи состава, на основании которой выполняется действие.

Формат `uuid`.

**status** `string` *required*

Текущее состояние записи. Допустимые значения `active`, `inactive`, `removed`.

**target\_id** `string` *required*

Идентификатор сотрудника в CRM, в том числе незарегистрированного участника состава (UUID).

Формат `uuid`.

**user\_id** `string | null` *required*

Идентификатор зарегистрированного пользователя CRM. Null, если аккаунт ещё не зарегистрирован.

**version** `integer` *required*

Версия записи. Диапазон от `0` до `9007199254740991`.

## Ошибки

| HTTP | Значение |
| - | - |
| `400` | Некорректные параметры запроса. |
| `401` | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
| `403` | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
| `404` | Запись не найдена или недоступна в данном контексте. |
| `409` | Конфликт состояния или ключа идемпотентности. Получите актуальную ревизию перед новым действием. |
| `422` | Данные не прошли проверку формата или ограничений. Подробности находятся в поле errors. |
| `429` | Превышен лимит запросов. Дождитесь интервала, указанного в заголовке Retry-After. |
| `500` | Внутренняя ошибка сервера. |
| `503` | Сервис временно недоступен. Повторите запрос позднее. |

См. [формат ошибок и правила повторов](https://docs.arzguard.com/cerberus-crm/requests-and-errors.md).

## Пример

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

```bash cURL theme={null}
curl --request POST \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  --header "Idempotency-Key: $OPERATION_KEY" \
  --header 'Content-Type: application/json' \
  --data-binary '{
  "action": {
    "attachment_ids": [],
    "evidence_cases": [],
    "expected_revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "material_url": null,
    "operation": "promotion",
    "reason": "Решение руководителя",
    "recommendations": [
      "yes",
      "yes",
      "not_sure"
    ],
    "target_id": "01910000-0000-7000-8000-000000000002",
    "server_id": 102,
    "position_id": "senior_moderator"
  },
  "moderator": {
    "provider": "discord",
    "platform_user_id": "123456789012345678"
  }
}' \
  'https://test.crm.arzguard.com/api/partner/v1/personnel/actions'
```

```json HTTP 200, сокращённый ответ theme={null}
{
  "operation": "promotion",
  "position_id": "senior_moderator",
  "registered": false,
  "source_id": "01910000-0000-7000-8000-000000000001",
  "status": "active",
  "target_id": "01910000-0000-7000-8000-000000000002",
  "user_id": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.