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

# Загрузить кадровое доказательство

> Загружает PNG или JPEG размером до 5 МиБ.

Загружает PNG или JPEG размером до 5 МиБ. Изображение нормализуется в PNG. Тело запроса содержит байты файла. Модератор передаётся в X-Moderator-Provider и X-Moderator-ID и должен иметь право снятия сотрудника в CRM. Требуется personnel:materials\_write. Загрузка привязана к боту, модератору, сотруднику и серверу. Полученный id используется в attachment\_ids снятия или его записи ЧС. Для прикрепления также требуется действующий personnel:materials\_write. Неприкреплённая загрузка действует до expires\_at. Максимум 20 незакреплённых загрузок на модератора.

## Доступ

`personnel:materials_write`. Модератору требуется право на снятие сотрудника в CRM.

**Authorization** `string` *required*

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

## Параметры

**X-Moderator-Provider** `string` *required*

Платформа модератора, выполнившего действие: discord или telegram. Допустимые значения `discord`, `telegram`.

**X-Moderator-ID** `string` *required*

ID модератора на выбранной платформе, строкой. Аккаунт должен быть подтверждён в CRM. До 20 символов.

**server\_id** `union` *required*

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

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

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

**Content-Type** `string` *required*

MIME-тип файла: при загрузке — image/png или image/jpeg. При получении доказательства — image/png.

Передайте байты файла в теле запроса. Поддерживаются `image/png` и `image/jpeg`.

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

HTTP `201`. Запись создана.

**content\_type** `string` *required*

MIME-тип содержимого файла.

**expires\_at** `string | null` *required*

Срок действия загрузки до её прикрепления к кадровому действию.

Формат `date-time`.

**id** `string` *required*

Идентификатор записи.

Формат `uuid`.

**size** `integer` *required*

Размер файла в байтах.

## Ошибки

| HTTP | Значение |
| - | - |
| `400` | Некорректные параметры запроса. |
| `401` | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
| `403` | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
| `404` | Запись не найдена или недоступна в данном контексте. |
| `409` | Конфликт состояния или ключа идемпотентности. Получите актуальную ревизию перед новым действием. |
| `413` | Размер тела запроса или загружаемого файла превышает допустимый предел. |
| `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 'X-Moderator-Provider: discord' \
  --header 'X-Moderator-ID: 123456789012345678' \
  --header 'Content-Type: image/png' \
  --data-binary '@evidence.png' \
  'https://test.crm.arzguard.com/api/partner/v1/personnel/materials/upload?server_id=102&target_id=01910000-0000-7000-8000-000000000002'
```

```json HTTP 201, сокращённый ответ theme={null}
{
  "content_type": "image/png",
  "expires_at": "2026-11-16T13:00:00+03:00",
  "id": "01910000-0000-7000-8000-000000000001",
  "size": 54817
}
```


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