> ## 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 enkeltbiomarkører i en time

Legg til én eller flere individuelle biomarkører på en time som à la carte-tester, utenfor et
forhåndsbygget panel. Rutingbeslutninger tas nedstrøms av ordrelogistikk-pipelinen basert
på hver biomarkørs koblinger per lab.

Det resulterende settet valideres synkront mot kompletthetsreglene til hver lab. Noen biomarkører
kan bare fås ved å bestille dem sammen med andre – en LDL/HDL-ratio leveres for eksempel
av en bestilling som også returnerer LDL og HDL, så å be om ratioen alene gir ikke en
sammenhengende bestilling. (Det er de samme komponentene ratioen *prises* etter – se
`pricing`-oversikten i [List opp biomarkører](https://docs.anivahealth.com/no/api/biomarkers/list-biomarkers.md).) Når settet ikke kan
bestilles komplett, returnerer kallet `400` med en `validation`-payload og **ingenting lagres**, så du
kan prøve deg frem til et gyldig sett:

1. `PATCH … { "biomarker_ids": [45] }` (LDL/HDL-ratio alene) → `400`;
   `validation.failures[].fix_options[].add_biomarkers` lister opp LDL og HDL.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (ratio + LDL + HDL) → `200`.

Den samme løkken dekker biomarkører som Aniva bare selger i en posisjon: ber du om én alene,
returnerer kallet `400` med `error: "biomarker_requires_position"` og posisjonene som selger den. Se
[Prising](https://docs.anivahealth.com/no/concepts/pricing.md).

[List opp biomarkører](https://docs.anivahealth.com/no/api/biomarkers/list-biomarkers.md) oppgir noen biomarkører som `price_cents: null`.
Disse biomarkørene er **ikke kuratert**: Aniva har ikke priset dem. Hvis du legger til en slik, returnerer kallet
`400` med `error: "biomarker_not_priced"`. Ingen annen biomarkør løser denne feilen, fordi `null`
betyr at du ikke har noen pris å kjøpe markøren for. Kit-markører er unntaket. Legg til panelet
som er kittet, så følger medlemmene med panelet. Kallet godtar også et medlem du legger til på
en time som allerede har det panelet.

Ved kapillær blodprøvetaking (`draw_method: capillary`) pakkes blodprøvetakingen i mikrotainere. Paneler går først, i
bestillingsrekkefølge. Individuelle biomarkører fyller deretter den ledige plassen i panelmikrotainerne. Når de
trenger mer plass, åpner de nye mikrotainere. Vi fordeler dem jevnt. Hver mikrotainer rommer maksimalt
150 µl med individuelle biomarkører. En biomarkør som trenger mer enn 150 µl i sin egen mikrotainer, får aldri
plass, og det gjør heller ikke en biomarkør uten kuratert volum. Hvis det resulterende settet bryter denne regelen,
returnerer kallet `400` med en `error`-melding og ingenting lagres.

Dette kallet er idempotent: biomarkører som allerede ligger på timen, beholdes.

Krever scopene `appointments_schedule` og `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Biomarkører kan ikke legges til etter at du har kalt [Bekreft
> blodprøvetaking](https://docs.anivahealth.com/no/api/appointments/confirm-blood-draw.md). Forsøk på å endre en bekreftet time returnerer
> `409 Conflict`.

## Forespørsel

### Stiparametere

**id** `string` *required*

Unik identifikator (UUID) for timen.

### Body-parametere

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

Array med biomarkør-ID-er som skal legges til. Må inneholde minst ett element. Bruk [List opp
biomarkører](https://docs.anivahealth.com/no/api/biomarkers/list-biomarkers.md) for å finne ID-er.

## Respons

Hvis kallet lykkes, returnerer API-et `200 OK` som bekrefter at biomarkørene er lagt til.

**success** `boolean`

`true` når biomarkørene er lagt til på timen.

### Lese en `400`

Hver kompletthetsvaliderings- og katalog-`400` inneholder en setning i `message`. En body-validerings- eller
mikrotainer-`400` inneholder bare `error`. Forgren på `error`. Ved en
kompletthetsvalideringsfeil er `error` en setning. Ved en katalogfeil er `error` en maskinkode:
`biomarker_not_priced` eller `biomarker_requires_position`.

**Kompletthetsvalidering** – settet kan ikke bestilles komplett hos noen lab:

* `validation.failures[]` – finnes bare ved kompletthetsvalideringsfeil (mangler ved vanlige
  body-valideringsfeil). Én oppføring per biomarkørgruppe ingen lab kan levere, med
  `biomarker_ids` som feilet og `fix_options[]`, med minste alternativ først. Hvert alternativs
  `add_biomarkers` (`{ id, name }`) er et sett du legger til ALLE fra – behold de opprinnelige, legg til disse og
  prøv igjen. En tom `fix_options` betyr at det ikke hjelper å legge til noe; fjern biomarkøren i stedet.

**Biomarkør uten pris** – Aniva har ikke priset denne biomarkøren. [List opp
biomarkører](https://docs.anivahealth.com/no/api/biomarkers/list-biomarkers.md) oppgir den som `price_cents: null`, eller utelater den når den
er en ratio med en komponent uten pris. `error` er `biomarker_not_priced`, og `biomarker_id` angir
markøren. Ingen annen biomarkør løser denne feilen, så fjern biomarkøren. To vilkår gjør en
biomarkør bestillbar: En lab Aniva kan rute til må levere den, **og** Aniva-katalogen må prise
den.

**Posisjonsbundet biomarkør** – en biomarkør som bare selges i en posisjon, uten noen dekkende posisjon i
settet. `error` er `biomarker_requires_position`, `biomarker_id` angir markøren, og `positions[]`
lister opp hver posisjon som selger den, billigst først. Legg til alle biomarkørene i én av dem. Se
[Prising](https://docs.anivahealth.com/no/concepts/pricing.md) for modellen, og `pricing.positions` i [Hent
biomarkør](https://docs.anivahealth.com/no/api/biomarkers/get-biomarker.md) for det fullstendige medlemssettet til en posisjon.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | `biomarker_ids` er tom / ikke heltall, settet feiler kompletthetsvalidering (`validation.failures`), det legger til en biomarkør Aniva ikke har priset (`error: "biomarker_not_priced"`), det inneholder en posisjonsbundet biomarkør ingen posisjon i settet dekker (`error: "biomarker_requires_position"`), eller ved kapillær blodprøvetaking får ikke biomarkørene plass i mikrotainerne sine. |
| `403` | Forbidden – manglende scope eller time utenfor tilgangskonteksten. |
| `404` | Time eller én eller flere biomarkører ble ikke funnet. |
| `409` | Conflict – biomarkører kan ikke endres etter at blodprøvetakingen er bekreftet. |
| `500` | Intern serverfeil. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [45, 43, 42]
  }'
```

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

```json 400 (closure validation) theme={null}
{
  "error": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "message": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "validation": {
    "failures": [
      {
        "biomarker_ids": [45],
        "fix_options": [
          {
            "add_biomarkers": [
              { "id": 43, "name": "LDL Cholesterol" },
              { "id": 42, "name": "HDL Cholesterol" }
            ]
          }
        ]
      }
    ]
  }
}
```

```json 400 (biomarker Aniva has not priced) theme={null}
{
  "error": "biomarker_not_priced",
  "message": "Adrenaline, 24h urine carries no price in the catalog you can order from — GET /api/v1/biomarkers/1465 reports price_cents: null for it, and a marker with no price cannot be ordered.",
  "biomarker_id": 1465
}
```

```json 400 (biomarker sold only inside a position) theme={null}
{
  "error": "biomarker_requires_position",
  "message": "Mean Platelet Volume (MPV) is not sold on its own — it comes only inside a position. Add every biomarker of one of the positions listed here; the cheapest is \"Blood Count (extended)\".",
  "biomarker_id": 77,
  "positions": [
    {
      "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
      "name": "Blood Count (extended)",
      "price_cents": 460,
      "retail_cents": 529
    }
  ]
}
```

```json 400 (capillary, does not fit) theme={null}
{
  "error": "Some individual biomarkers need more than 150 µl of one lab's microtainer. Remove some of them."
}
```

```json 409 theme={null}
{
  "error": "Individual biomarkers cannot be modified after blood draw has been confirmed"
}
```

```json 404 theme={null}
{
  "error": "Biomarkers not found: 99999"
}
```


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