> ## 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.

# Подготовить повышение, понижение или снятие

> Проверяет полномочия модератора для выбранного действия и возвращает доступные должности и актуальную revision.

Проверяет полномочия модератора для выбранного действия и возвращает доступные должности и актуальную revision. Передайте её как expected\_revision при выполнении действия.

## Доступ

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

**Authorization** `string` *required*

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

## Параметры

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

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

**moderator** `object` *required*

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

**Поля**

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

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

**provider** `string` *required*

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

**operation** `string` *required*

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

**target** `object` *required*

**Поля**

**context** `string`

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

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

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

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

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

Формат `uuid`.

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

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

**can\_direct\_blacklist** `boolean` *required*

Может ли модератор занести в локальный чёрный список без отдельного рассмотрения.

**can\_direct\_global\_blacklist** `boolean` *required*

Может ли модератор занести в глобальный чёрный список без отдельного рассмотрения.

**can\_global\_blacklist** `boolean` *required*

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

**can\_local\_blacklist** `boolean` *required*

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

**can\_remove** `boolean` *required*

Может ли указанный модератор снять сотрудника.

**can\_request\_blacklist** `boolean` *required*

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

**context** `string`

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

**current\_role** `object` *required*

Текущая должность сотрудника.

**Поля**

**id** `string` *required*

Код должности CRM.

**label** `string` *required*

Название должности для отображения.

**rank** `integer` *required*

Порядок должности в иерархии CRM.

**demotion\_roles** `object[] | null` *required*

Должности, доступные модератору для понижения сотрудника.

**Поля**

**id** `string` *required*

Код должности CRM.

**label** `string` *required*

Название должности для отображения.

**rank** `integer` *required*

Порядок должности в иерархии CRM.

**promotion\_roles** `object[] | null` *required*

Должности, доступные модератору для повышения сотрудника.

**Поля**

**id** `string` *required*

Код должности CRM.

**label** `string` *required*

Название должности для отображения.

**rank** `integer` *required*

Порядок должности в иерархии CRM.

**registered** `boolean` *required*

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

**revision** `string` *required*

Ревизия текущего состояния. Передавайте актуальное значение, полученное при подготовке действия или чтении состояния. До 64 символов.

**server\_id** `string`

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

Формат `uuid`.

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

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

Формат `uuid`.

**started\_on** `string | null` *required*

Дата начала работы в формате ГГГГ-ММ-ДД.

Формат `date`.

**status** `string | null` *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).

## Пример

В примере использованы условные идентификаторы.

```bash cURL theme={null}
curl --request POST \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  --header 'Content-Type: application/json' \
  --data-binary '{
  "moderator": {
    "provider": "discord",
    "platform_user_id": "123456789012345678"
  },
  "operation": "promotion",
  "target": {
    "target_id": "01910000-0000-7000-8000-000000000002",
    "server_id": 102
  }
}' \
  'https://test.crm.arzguard.com/api/partner/v1/personnel/actions/options'
```

```json HTTP 200, сокращённый ответ theme={null}
{
  "can_direct_blacklist": false,
  "can_direct_global_blacklist": false,
  "can_global_blacklist": false,
  "can_local_blacklist": false,
  "can_remove": false,
  "can_request_blacklist": false,
  "current_role": {
    "id": "01910000-0000-7000-8000-000000000001",
    "label": "example",
    "rank": 1
  }
}
```


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