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

# Egyedi biomarkerek hozzáadása

> Adj hozzá külön választható biomarkereket egy otthoni tesztkészlet-rendeléshez

Adj hozzá egy vagy több külön választható biomarkert egy meglévő otthoni tesztkészlet-rendeléshez, az előre összeállított paneleken kívül. Ez a végpont idempotens — a már hozzárendelt biomarkerek megmaradnak.

Szükséges hozzá a `home_kit_orders_manage` scope és a
`home_kit_orders_individual_biomarker_selection` képesség-scope. Az otthoni tesztkészleteket panelenként lehet rendelni,
így az egyedi markereket partnerenként engedélyezzük. Kérd az Anivától, ha az integrációdnak szüksége van rá.

> [!WARNING]
>
> Biomarkereket csak addig lehet hozzáadni, amíg a tesztkészlet `pending` státuszban van. Amint a tesztkészlet `dispatched` állapotba kerül, az
> összetétele zárolódik, és ez a hívás `409 Conflict` választ ad vissza — a fizikai készletet a kiválasztott panelek és biomarkerek alapján meghatározott,
> fix számú csővel küldjük el, így a tartalma a feladás után már nem változtatható.
> Az `activated` és `cancelled` készletek szintén zároltak. Ha egy zárolt készlet vizsgálatait
> módosítanod kell, keresd közvetlenül az Anivát — ez általában még lehetséges, és
> mi elvégezzük helyetted a módosítást, hogy a készlet tartalma összhangban maradjon.

## Kérés

### Útvonalparaméterek

**id** `string` *required*

Annak az otthoni tesztkészlet-rendelésnek az egyedi azonosítója (UUID), amelyhez biomarkereket adsz hozzá.

### Törzsparaméterek

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

Az otthoni tesztkészlet-rendeléshez hozzáadandó biomarker-azonosítók tömbje. Legalább egy elemet tartalmaznia kell. Használd a
[Biomarkerek listázása](https://docs.anivahealth.com/hu/api/biomarkers/list-biomarkers.md) végpontot `home_kit=true` paraméterrel a biomarker-azonosítók megkereséséhez.

## Válasz

Siker esetén az API `200 OK` választ ad vissza, megerősítve a biomarkerek hozzáadását.

**success** `boolean`

`true`, ha a biomarkereket sikeresen hozzáadtuk az otthoni tesztkészlet-rendeléshez.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Validációs hiba — pl. a `biomarker_ids` üres, vagy érvénytelen értéket tartalmaz. |
| `403` | Tiltott — hiányzik a `home_kit_orders_manage` vagy a `home_kit_orders_individual_biomarker_selection` képesség-scope, vagy az otthoni tesztkészlet-rendelés kívül esik a jogosultsági körödön. |
| `404` | Az otthoni tesztkészlet-rendelés vagy egy vagy több biomarker nem található. |
| `409` | Ütközés — a készlet `dispatched`, `activated` vagy `cancelled` státuszban van; a panel- és biomarker-összetétele zárolva van, és már nem módosítható. |
| `500` | Belső szerverhiba. |

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