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

> Losse biomarkers verwijderen uit een thuistestkit-bestelling

Verwijder een of meer losse biomarkers uit een bestaande thuistestkitbestelling. Verwijderen is idempotent: biomarkers die niet gekoppeld zijn, worden genegeerd in plaats van geweigerd. Zie [Idempotentie](https://docs.anivahealth.com/nl/concepts/idempotency.md).

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 verwijderd zolang de kit `pending` is. Zodra de kit `dispatched` is, is de
> samenstelling vergrendeld en geeft deze aanroep `409 Conflict` terug — de fysieke kit wordt verzonden met een vast
> aantal buisjes op basis van de geselecteerde panels en biomarkers, dus de inhoud kan niet meer veranderen
> nadat deze is verstuurd. Kits met de status `activated` en `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 steeds 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 waaruit je biomarkers verwijdert.

### Bodyparameters

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

Array met biomarker-identifiers om uit de thuistestkitbestelling te verwijderen. Moet minstens één item bevatten.

## Respons

Bij succes geeft de API `200 OK` terug ter bevestiging dat de biomarkers zijn verwijderd.

**success** `boolean`

`true` wanneer de biomarkers met succes uit de thuistestkitbestelling zijn verwijderd.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Validatiefout — bijv. `biomarker_ids` is leeg of bevat een ongeldige waarde. |
| `403` | Geen toegang — de scope `home_kit_orders_manage` of de capability-scope `home_kit_orders_individual_biomarker_selection` ontbreekt, of de thuistestkitbestelling valt buiten je toegangsbereik. |
| `404` | Thuistestkitbestelling niet gevonden. |
| `409` | Conflict — de kit heeft de status `dispatched`, `activated` of `cancelled`; het panel en de biomarkersamenstelling zijn vergrendeld en kunnen niet meer worden gewijzigd. |
| `409` | Conflict — dit zijn de enige markers die een vervangende kit opnieuw uitvoert; als je ze verwijdert, blijft er niets over om te bestellen. |
| `500` | Interne serverfout. |

```bash cURL theme={null}
curl --request DELETE \
  --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]
  }'
```

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

```json 404 theme={null}
{
  "error": "Home kit order not found"
}
```


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