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

# Legg til enkeltbiomarkører

> Legg til à-la-carte-biomarkører i en bestilling av hjemmetestsett

Legg til én eller flere enkeltstående biomarkører i en eksisterende bestilling av hjemmetestsett, utenom et forhåndsbygget panel. Dette endepunktet er idempotent – biomarkører som allerede er lagt til, beholdes.

Krever scope-et `home_kit_orders_manage` pluss
funksjons-scope-et `home_kit_orders_individual_biomarker_selection`. Hjemmetestsett bestilles per panel,
så enkeltmarkører aktiveres per partner. Spør Aniva hvis integrasjonen din trenger det.

> [!WARNING]
>
> Biomarkører kan bare legges til mens settet har status `pending`. Når settet er `dispatched`, er
> sammensetningen låst, og dette kallet returnerer `409 Conflict` – det fysiske settet sendes med et fast
> antall prøverør basert på valgte paneler og biomarkører, så innholdet kan ikke endres
> etter at det er sendt. Sett med status `activated` og `cancelled` er også låst. Hvis du må
> endre testene i et låst sett, tar du kontakt med Aniva direkte – det er som regel fortsatt mulig, og
> vi gjør endringen for deg for å holde innholdet i settet konsistent.

## Forespørsel

### Stiparametere

**id** `string` *required*

Unik identifikator (UUID) for bestillingen av hjemmetestsett som biomarkørene skal legges til i.

### Body-parametere

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

Liste med biomarkør-ID-er som skal legges til i bestillingen av hjemmetestsett. Må inneholde minst ett element. Bruk
[Vis biomarkører](https://docs.anivahealth.com/no/api/biomarkers/list-biomarkers.md) med `home_kit=true` for å finne biomarkør-ID-er.

## Respons

Ved suksess returnerer API-et `200 OK` som bekrefter at biomarkørene er lagt til.

**success** `boolean`

`true` når biomarkørene er lagt til i bestillingen av hjemmetestsett.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfeil – f.eks. er `biomarker_ids` tom eller inneholder en ugyldig verdi. |
| `403` | Ingen tilgang – mangler `home_kit_orders_manage` eller funksjons-scope-et `home_kit_orders_individual_biomarker_selection`, eller bestillingen av hjemmetestsett ligger utenfor tilgangsområdet ditt. |
| `404` | Fant ikke bestillingen av hjemmetestsett eller én eller flere biomarkører. |
| `409` | Konflikt – settet har status `dispatched`, `activated` eller `cancelled`; panel- og biomarkørsammensetningen er låst og kan ikke lenger endres. |
| `500` | Intern serverfeil. |

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