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

# Tilføj individuelle biomarkører

> Tilføj à la carte-biomarkører til en ordre på hjemmetestkit

Tilføj en eller flere enkeltstående biomarkører til en eksisterende hjemmetestkitordre uden for et færdigsammensat panel. Dette endpoint er idempotent — allerede tilknyttede biomarkører bevares.

Kræver scopet `home_kit_orders_manage` samt
funktionsscopet `home_kit_orders_individual_biomarker_selection`. Hjemmetestkits bestilles pr. panel,
så enkeltmarkører aktiveres pr. partner. Spørg Aniva, hvis din integration har brug for det.

> [!WARNING]
>
> Biomarkører kan kun tilføjes, mens kittet er `pending`. Når kittet er `dispatched`, er dets
> sammensætning låst, og dette kald returnerer `409 Conflict` — det fysiske kit sendes med et fast
> antal prøverør baseret på de valgte paneler og biomarkører, så indholdet kan ikke ændres,
> efter det er sendt. Kits med statussen `activated` og `cancelled` er ligeledes låst. Hvis du har brug for at
> ændre testene på et låst kit, skal du kontakte Aniva direkte — det er som regel stadig muligt, og
> vi foretager ændringen for dig, så kittets indhold stemmer overens.

## Forespørgsel

### Stiparametre

**id** `string` *required*

Unikt id (UUID) for den hjemmetestkitordre, der skal tilføjes biomarkører til.

### Body-parametre

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

Array af biomarkør-id'er, der skal tilføjes til hjemmetestkitordren. Skal indeholde mindst ét element. Brug
[Vis biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md) med `home_kit=true` for at finde biomarkør-id'er.

## Svar

Ved succes returnerer API'et `200 OK` som bekræftelse på, at biomarkørerne er blevet tilføjet.

**success** `boolean`

`true`, når biomarkørerne er blevet tilføjet til hjemmetestkitordren.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfejl — f.eks. hvis `biomarker_ids` er tom eller indeholder en ugyldig værdi. |
| `403` | Forbudt — mangler `home_kit_orders_manage` eller funktionsscopet `home_kit_orders_individual_biomarker_selection`, eller hjemmetestkitordren ligger uden for dine rettigheder. |
| `404` | Hjemmetestkitordre eller en eller flere biomarkører ikke fundet. |
| `409` | Konflikt — kittet er `dispatched`, `activated` eller `cancelled`; dets sammensætning af paneler og biomarkører er låst og kan ikke længere ændres. |
| `500` | Intern serverfejl. |

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