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

> Legg til blodprøvepaneler i en time

Legg til ett eller flere blodprøvepaneler på en eksisterende time. Du kan kalle dette endepunktet flere ganger for å bygge opp panelutvalget før du bekrefter blodprøvetakingen.

Krever scopet `appointments_schedule`.

> [!WARNING]
>
> Paneler 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å å legge til paneler på en bekreftet time returnerer `409 Conflict`.

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. Hvis det resulterende settet med paneler bryter denne regelen, returnerer kallet `400` med
en `error`-melding og ingen paneler legges til.

## Forespørsel

### Stiparametere

**id** `string` *required*

Unik identifikator (UUID) for timen panelene skal legges til på.

### Body-parametere

**panel\_ids** `string[]` *required*

Array med panel-UUID-er som skal legges til på timen. Må inneholde minst ett element.

## Respons

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

**success** `boolean`

`true` når panelene er lagt til på timen.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfeil – f.eks. at `panel_ids` er tom eller inneholder en ugyldig UUID – eller ved kapillær blodprøvetaking får de individuelle biomarkørene ikke lenger plass i mikrotainerne sine. |
| `403` | Forbidden – API-nøkkelen din har ikke tilgang til denne operasjonen. |
| `404` | Time eller ett eller flere paneler ble ikke funnet. |
| `409` | Conflict – paneler kan ikke legges til etter at blodprøvetakingen er bekreftet, eller et panel er et hjemmetestsett (`error_name: "home_kit_appointment_mismatch_error"`). Bestill et hjemmetestsett som en [bestilling av hjemmetestsett](https://docs.anivahealth.com/no/api/home-kit-orders/create-home-kit.md). |
| `500` | Intern serverfeil. |

### Hjemmetestsettpanel

Et hjemmetestsett sendes til pasienten og tas ikke ved blodprøvetaking på en time. Hvis et panel i `panel_ids` er
et hjemmetestsett, returnerer kallet `409` og legger ikke til noe panel. Body-en har disse feltene:

**error** `string`

Menneskelesbar årsak.

**error\_name** `string`

Alltid `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Timen som panelet ikke ble lagt til på.

**panel\_id** `string`

Hjemmetestsettpanelet.

**home\_kit\_provider** `string | null`

Leverandøren av hjemmetestsettet for panelet, eller `null` når den ikke er kjent.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9",
      "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
    ]
  }'
```

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

```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": "Panels cannot be added after blood draw has been confirmed"
}
```

```json 409 (home kit panel) theme={null}
{
  "error": "Panel e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0 is a home kit (biomes) and cannot attach to appointment c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a — order it via home-kit orders",
  "error_name": "home_kit_appointment_mismatch_error",
  "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "panel_id": "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0",
  "home_kit_provider": "biomes"
}
```

```json 404 theme={null}
{
  "error": "Panels not found: e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
}
```


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