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

> Tilføj blodprøvepaneler til en tid

Tilføj et eller flere blodprøvepaneler til en eksisterende tid. Du kan kalde dette endpoint flere gange for at opbygge panelvalget, før du bekræfter blodprøvetagningen.

Kræver scopet `appointments_schedule`.

> [!WARNING]
>
> Paneler kan ikke tilføjes, efter du har kaldt [Bekræft blodprøvetagning](https://docs.anivahealth.com/da/api/appointments/confirm-blood-draw.md).
> Forsøg på at tilføje paneler til en bekræftet tid returnerer `409 Conflict`.

Ved en kapillær blodprøvetagning (`draw_method: capillary`) pakkes den i microtainere. Paneler kommer først i
bookingrækkefølge. Individuelle biomarkører fylder derefter den ledige plads i panelmicrotainerne. Når de
har brug for mere plads, åbner de nye microtainere. Vi fordeler dem jævnt. Hver microtainer rummer højst
150 µl individuelle biomarkører. Hvis det resulterende sæt af paneler bryder denne regel, returnerer kaldet `400` med
en `error`-besked, og intet panel tilføjes.

## Forespørgsel

### Stiparametre

**id** `string` *required*

Unikt id (UUID) for den tid, som panelerne skal tilføjes til.

### Body-parametre

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

Array af panel-UUID'er, der skal tilføjes til tiden. Skal indeholde mindst ét element.

## Svar

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

**success** `boolean`

`true`, når panelerne er tilføjet til tiden.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfejl — f.eks. at `panel_ids` er tom eller indeholder en ugyldig UUID — eller ved en kapillær blodprøvetagning kan de individuelle biomarkører ikke længere være i deres microtainere. |
| `403` | Forbudt — din API-nøgle har ikke adgang til denne handling. |
| `404` | Tiden eller et eller flere paneler blev ikke fundet. |
| `409` | Konflikt — paneler kan ikke tilføjes, efter blodprøvetagningen er bekræftet, eller et panel er et hjemmetestkit (`error_name: "home_kit_appointment_mismatch_error"`). Bestil et hjemmetestkit som en [bestilling af hjemmetestkit](https://docs.anivahealth.com/da/api/home-kit-orders/create-home-kit.md). |
| `500` | Intern serverfejl. |

### Hjemmetestkitpanel

Et hjemmetestkit sendes til patienten og tages ikke ved en tid. Hvis et panel i `panel_ids` er
et hjemmetestkit, returnerer kaldet `409` og tilføjer intet panel. Body indeholder disse felter:

**error** `string`

Menneskelæsbar årsag.

**error\_name** `string`

Altid `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Den tid, som panelet ikke blev tilføjet til.

**panel\_id** `string`

Hjemmetestkitpanelet.

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

Udbyderen af panelets hjemmetestkit, eller `null` hvis den er ukendt.

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