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

# Panels hinzufügen

> Bluttest-Panels zu einem Termin hinzufügen

Füge einem bestehenden Termin ein oder mehrere Bluttest-Panels hinzu. Du kannst diesen Endpunkt mehrmals aufrufen, um die Panel-Auswahl vor dem Bestätigen der Blutabnahme zusammenzustellen.

Erfordert den Scope `appointments_schedule`.

> [!WARNING]
>
> Nachdem du [Blutabnahme bestätigen](https://docs.anivahealth.com/de/api/appointments/confirm-blood-draw.md) aufgerufen hast, können keine Panels mehr hinzugefügt werden.
> Der Versuch, einem bestätigten Termin Panels hinzuzufügen, gibt `409 Conflict` zurück.

Bei einer kapillaren Blutabnahme (`draw_method: capillary`) wird die Blutabnahme auf Microtainer aufgeteilt. Panels kommen zuerst, in
Buchungsreihenfolge. Einzelne Biomarker füllen dann den freien Platz in den Panel-Microtainern. Wenn sie
mehr Platz brauchen, öffnen sie neue Microtainer. Wir verteilen sie gleichmäßig. Jeder Microtainer fasst höchstens
150 µl an einzelnen Biomarkern. Verstößt die resultierende Auswahl an Panels gegen diese Regel, gibt der Aufruf `400` mit
einer `error`-Meldung zurück und es wird kein Panel hinzugefügt.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige Kennung (UUID) des Termins, dem Panels hinzugefügt werden sollen.

### Body-Parameter

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

Array mit Panel-UUIDs, die dem Termin hinzugefügt werden sollen. Muss mindestens ein Element enthalten.

## Antwort

Bei Erfolg gibt die API `200 OK` zurück und bestätigt, dass die Panels hinzugefügt wurden.

**success** `boolean`

`true`, wenn die Panels erfolgreich zum Termin hinzugefügt wurden.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Validierungsfehler – z. B. ist `panel_ids` leer oder enthält eine ungültige UUID – oder bei einer kapillaren Blutabnahme passen die einzelnen Biomarker nicht mehr in ihre Microtainer. |
| `403` | Verboten – dein API-Schlüssel hat keinen Zugriff auf diesen Vorgang. |
| `404` | Termin oder ein oder mehrere Panels nicht gefunden. |
| `409` | Konflikt – Panels können nach Bestätigung der Blutabnahme nicht mehr hinzugefügt werden, oder ein Panel ist ein Heimtest-Kit (`error_name: "home_kit_appointment_mismatch_error"`). Bestelle ein Heimtest-Kit als [Heimtest-Kit-Bestellung](https://docs.anivahealth.com/de/api/home-kit-orders/create-home-kit.md). |
| `500` | Interner Serverfehler. |

### Heimtest-Kit-Panel

Ein Heimtest-Kit wird an den Patienten gesendet und nicht bei einem Termin abgenommen. Ist ein Panel in `panel_ids`
ein Heimtest-Kit, gibt der Aufruf `409` zurück und fügt kein Panel hinzu. Der Body hat diese Felder:

**error** `string`

Für Menschen lesbarer Grund.

**error\_name** `string`

Immer `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Der Termin, dem das Panel nicht hinzugefügt wurde.

**panel\_id** `string`

Das Heimtest-Kit-Panel.

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

Der Heimtest-Kit-Anbieter des Panels oder `null`, wenn er nicht bekannt ist.

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