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

# Lägg till paneler

> Lägg till blodprovspaneler i en bokning

Lägg till en eller flera blodprovspaneler i en befintlig bokning. Du kan anropa den här endpointen flera gånger för att bygga upp panelurvalet innan du bekräftar blodprovstagningen.

Kräver scopet `appointments_schedule`.

> [!WARNING]
>
> Paneler kan inte läggas till efter att du har anropat [Bekräfta blodprovstagning](https://docs.anivahealth.com/sv/api/appointments/confirm-blood-draw.md).
> Försök att lägga till paneler i en bekräftad bokning returnerar `409 Conflict`.

Vid en kapillär blodprovstagning (`draw_method: capillary`) packas provet i mikrotainers. Paneler kommer först, i
bokningsordning. Enskilda biomarkörer fyller sedan det lediga utrymmet i panelernas mikrotainers. När de
behöver mer plats öppnas nya mikrotainers. Vi fördelar dem jämnt. Varje mikrotainer rymmer högst
150 µl enskilda biomarkörer. Om den resulterande uppsättningen paneler bryter mot den här regeln returnerar anropet `400` med
ett `error`-meddelande och ingen panel läggs till.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för bokningen som paneler ska läggas till i.

### Body-parametrar

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

Array med panel-UUID:n att lägga till i bokningen. Måste innehålla minst ett objekt.

## Svar

Om anropet lyckas returnerar API:et `200 OK` som bekräftelse på att panelerna har lagts till.

**success** `boolean`

`true` när panelerna har lagts till i bokningen.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel – t.ex. att `panel_ids` är tom eller innehåller ett ogiltigt UUID – eller, vid en kapillär blodprovstagning, att de enskilda biomarkörerna inte längre får plats i sina mikrotainers. |
| `403` | Åtkomst nekad – din API-nyckel har inte behörighet till den här åtgärden. |
| `404` | Bokningen eller en eller flera paneler hittades inte. |
| `409` | Konflikt – paneler kan inte läggas till efter att blodprovstagningen har bekräftats, eller så är en panel ett hemtestkit (`error_name: "home_kit_appointment_mismatch_error"`). Beställ ett hemtestkit som en [beställning av hemtestkit](https://docs.anivahealth.com/sv/api/home-kit-orders/create-home-kit.md). |
| `500` | Internt serverfel. |

### Hemtestkitpanel

Ett hemtestkit skickas till patienten och tas inte vid en bokning. Om en panel i `panel_ids` är
ett hemtestkit returnerar anropet `409` och lägger inte till någon panel. Bodyn har de här fälten:

**error** `string`

Människoläsbar orsak.

**error\_name** `string`

Alltid `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Bokningen som panelen inte lades till i.

**panel\_id** `string`

Hemtestkitpanelen.

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

Panelens leverantör av hemtestkit, eller `null` när den inte är känd.

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