> ## 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:appoint` для назначения, `personnel:restore` для восстановления.

**Authorization** `string` *required*

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

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

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

## Параметры

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

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

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

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

**appointment** `object` *required*

**Поля**

**appointment\_reason** `string` *required*

Причина назначения или восстановления. До 2000 символов.

**birth\_date** `string`

Дата рождения в формате YYYY-MM-DD, от 1900-01-01 до текущей даты по Москве. null — дата не указана.

Формат `date`.

**city** `string` *required*

Город проживания сотрудника. До 128 символов.

**country** `string` *required*

Страна проживания сотрудника. До 128 символов.

**discord\_id** `string` *required*

ID сотрудника в Discord, строкой.

**display\_name** `string`

Отображаемое имя сотрудника. Поле устарело. До 256 символов.

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

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

**expected\_version** `integer` *required*

Ожидаемая версия записи из последнего ответа API. Нужна для защиты от одновременных изменений.

**first\_name** `string` *required*

Имя сотрудника. До 128 символов.

**forum\_url** `string` *required*

Ссылка на профиль сотрудника на форуме. До 2048 символов.

**operation** `string` *required*

Назначение: appointment — новое назначение, restoration — восстановление. Допустимые значения `appointment`, `restoration`.

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

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

**reuse\_profile** `boolean`

Использовать существующие данные профиля при восстановлении.

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

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

**source\_assignment\_id** `string`

Идентификатор исходного назначения для восстановления. При новом назначении не передавайте.

Формат `uuid`.

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

ID сотрудника в Telegram, строкой. Null, если не указан.

**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`. Запрос выполнен успешно.

**assignment\_id** `string` *required*

Идентификатор назначения сотрудника.

Формат `uuid`.

**operation** `string` *required*

Код выполняемой операции. Допустимые значения указаны в схеме.

**registered** `boolean` *required*

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

**server\_id** `string` *required*

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

Формат `uuid`.

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

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

**version** `integer` *required*

Версия записи.

## Ошибки

| 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 '{
  "appointment": {
    "appointment_reason": "Решение руководителя",
    "city": "Москва",
    "country": "Россия",
    "discord_id": "123456789012345679",
    "expected_revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "expected_version": 1,
    "first_name": "Алексей",
    "forum_url": "https://forum.example.com/members/example.123/",
    "operation": "appointment",
    "position_id": "senior_moderator",
    "server_id": 102,
    "telegram_id": null
  },
  "moderator": {
    "provider": "discord",
    "platform_user_id": "123456789012345678"
  }
}' \
  'https://test.crm.arzguard.com/api/partner/v1/personnel/appointments'
```

```json HTTP 200, сокращённый ответ theme={null}
{
  "assignment_id": "01910000-0000-7000-8000-000000000001",
  "operation": "example",
  "registered": false,
  "server_id": "01910000-0000-7000-8000-000000000001",
  "user_id": null,
  "version": 1
}
```


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