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

# Individuele biomarkers toevoegen

> Losse biomarkers toevoegen aan een thuistestkit-bestelling

Voeg een of meer losse biomarkers toe aan een bestaande thuistestkitbestelling, buiten een vooraf samengesteld panel om. Dit endpoint is idempotent — al gekoppelde biomarkers blijven behouden.

Vereist de scope `home_kit_orders_manage` plus de
capability-scope `home_kit_orders_individual_biomarker_selection`. Thuistestkits worden per panel besteld,
dus losse markers worden per partner ingeschakeld. Vraag het aan Aniva als je integratie dit nodig heeft.

> [!WARNING]
>
> Biomarkers kunnen alleen worden toegevoegd zolang de kit `pending` is. Zodra de kit `dispatched` is, is de
> samenstelling vergrendeld en retourneert deze aanroep `409 Conflict` — de fysieke kit wordt verzonden met een vast
> aantal buisjes op basis van de gekozen panels en biomarkers, dus de inhoud kan na verzending niet meer
> veranderen. Kits met de status `activated` of `cancelled` zijn ook vergrendeld. Als je de
> tests op een vergrendelde kit moet wijzigen, neem dan rechtstreeks contact op met Aniva — meestal is het nog mogelijk, en
> wij voeren de wijziging voor je door om de inhoud van de kit consistent te houden.

## Verzoek

### Padparameters

**id** `string` *required*

Unieke identifier (UUID) van de thuistestkitbestelling om biomarkers aan toe te voegen.

### Bodyparameters

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

Array van biomarker-identifiers om aan de thuistestkitbestelling toe te voegen. Moet minstens één item bevatten. Gebruik
[Biomarkers ophalen](https://docs.anivahealth.com/nl/api/biomarkers/list-biomarkers.md) met `home_kit=true` om biomarker-ID's te vinden.

## Respons

Bij succes retourneert de API `200 OK` ter bevestiging dat de biomarkers zijn toegevoegd.

**success** `boolean`

`true` wanneer de biomarkers succesvol aan de thuistestkitbestelling zijn toegevoegd.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Validatiefout — bijvoorbeeld als `biomarker_ids` leeg is of een ongeldige waarde bevat. |
| `403` | Toegang geweigerd — `home_kit_orders_manage` of de capability-scope `home_kit_orders_individual_biomarker_selection` ontbreekt, of de thuistestkitbestelling valt buiten je machtigingsscope. |
| `404` | Thuistestkitbestelling of een of meer biomarkers niet gevonden. |
| `409` | Conflict — de kit heeft de status `dispatched`, `activated` of `cancelled`; de samenstelling van panels en biomarkers is vergrendeld en kan niet meer worden gewijzigd. |
| `500` | Interne serverfout. |

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