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