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

# Идентификаторы и версии записей

> Номера серверов, UUID сотрудников и записей состава, внешние ID, ревизии и точность баллов.

## Идентификаторы

| Поле | Как получить и использовать |
| - | - |
| `server_id` | Возьмите `number` или `id` из [GET /servers](https://docs.arzguard.com/cerberus-crm/api/get-servers.md). В описанных серверных параметрах принимаются номер и UUID. В JSON номер можно передать числом или строкой. |
| `target_id` | Для зарегистрированного сотрудника используйте `user_id`. Для записи состава без аккаунта используйте её `id`. Оба возвращают [состав](https://docs.arzguard.com/cerberus-crm/api/get-servers-server-id-roster.md) и [поиск](https://docs.arzguard.com/cerberus-crm/api/get-servers-server-id-users-lookup.md). |
| `moderator.platform_user_id` | ID аккаунта инициатора в Discord или Telegram. Передавайте строкой. |
| `position_id` | Код должности из [справочника](https://docs.arzguard.com/cerberus-crm/api/get-catalog.md). Для изменения выбирайте из вариантов, которые вернул метод подготовки. |
| `assignment_id` | Идентификатор назначения. При восстановлении используйте `source_assignment_id`, полученный для выбранной архивной записи. |

### Запись состава

```json Условная запись theme={null}
{
  "id": "01910000-0000-7000-8000-000000000001",
  "user_id": "01910000-0000-7000-8000-000000000002",
  "display_name": "Пример",
  "position_name": "Куратор модерации",
  "status": "active"
}
```

Если у записи ещё нет аккаунта CRM, её `user_id` равно `null`. Для методов, принимающих объект `target`, вложите туда `target_id` и `server_id`. Используйте поля ответа конкретного метода для других идентификаторов, например `sanction_id`, `request_id` или `entry_id`.

## Ревизии и версии

Ревизия описывает актуальное состояние, на котором основан выбор операции. Бот получает её из метода подготовки и передаёт в `revision` или `expected_revision` по контракту команды. Целочисленный `expected_version` берите из версии записи, которую собираетесь изменить.

Календарные даты передаются как `YYYY-MM-DD`. Время публикации новостей передаётся с часовым поясом. [Баллы](https://docs.arzguard.com/cerberus-crm/api/post-personnel-points-adjust.md) передаются целым числом сотых долей. Например, `125` означает 1,25 балла.


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