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

# Добавить отдельные биомаркеры

> Добавить отдельные биомаркеры в заказ набора для домашнего теста

Добавь один или несколько отдельных биомаркеров в существующий заказ набора для домашнего теста, вне готовой панели. Этот эндпоинт идемпотентен — уже привязанные биомаркеры сохраняются.

Требуется право доступа `home_kit_orders_manage`, а также дополнительное право доступа
`home_kit_orders_individual_biomarker_selection`. Наборы для домашнего теста заказываются по панелям,
поэтому отдельные маркеры включаются отдельно для каждого партнёра. Обратись в Aniva, если это нужно твоей интеграции.

> [!WARNING]
>
> Биомаркеры можно добавлять, только пока набор имеет статус `pending`. Как только набор переходит в статус `dispatched`, его
> состав блокируется и этот запрос возвращает `409 Conflict` — физический набор отправляется с фиксированным
> числом пробирок под выбранные панели и биомаркеры, поэтому его содержимое нельзя изменить
> после отправки. Наборы со статусами `activated` и `cancelled` также заблокированы. Если нужно
> изменить тесты в заблокированном наборе, обратись в Aniva напрямую — обычно это ещё возможно, и
> мы внесём изменения за тебя, чтобы содержимое набора оставалось согласованным.

## Запрос

### Параметры пути

**id** `string` *required*

Уникальный идентификатор (UUID) заказа набора для домашнего теста, в который нужно добавить биомаркеры.

### Параметры тела запроса

**biomarker\_ids** `integer[]` *required*

Массив идентификаторов биомаркеров для добавления в заказ набора для домашнего теста. Должен содержать хотя бы один элемент. Используй
[Список биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md) с `home_kit=true`, чтобы узнать ID биомаркеров.

## Ответ

При успехе API возвращает `200 OK`, подтверждая, что биомаркеры добавлены.

**success** `boolean`

`true`, если биомаркеры успешно добавлены в заказ набора для домашнего теста.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `400` | Ошибка валидации — например, `biomarker_ids` пустой или содержит некорректное значение. |
| `403` | Доступ запрещён — отсутствует право доступа `home_kit_orders_manage` или дополнительное право доступа `home_kit_orders_individual_biomarker_selection`, либо заказ набора для домашнего теста находится вне области твоих прав. |
| `404` | Заказ набора для домашнего теста либо один или несколько биомаркеров не найдены. |
| `409` | Конфликт — набор имеет статус `dispatched`, `activated` или `cancelled`; его состав панелей и биомаркеров заблокирован и больше не может меняться. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [42, 87]
  }'
```

```json 200 theme={null}
{
  "success": true
}
```

```json 404 theme={null}
{
  "error": "Biomarkers not found: 87"
}
```


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