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

> Bluttest-Panels aus einem Termin entfernen

Entferne ein oder mehrere Bluttest-Panels aus einem bestehenden Termin. Dadurch werden die geplanten Test-Snapshots gelöscht, die mit den angegebenen Panels verknüpft sind.

Das Entfernen ist idempotent: Panels, die nicht verknüpft sind, werden ignoriert statt abgelehnt. Siehe [Idempotenz](https://docs.anivahealth.com/de/concepts/idempotency.md).

Erfordert den Scope `appointments_schedule` oder `appointments_manage`.

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

Bei einer kapillaren Blutabnahme (`draw_method: capillary`) werden die einzelnen Biomarker zusammen
mit den Panels in Microtainer aufgeteilt. Wenn das verbleibende Set gegen die 150-µl-Regel aus
[Einzelne Biomarker hinzufügen](https://docs.anivahealth.com/de/api/appointments/add-individual-biomarkers.md) verstößt, gibt der
Aufruf `400` mit einer `error`-Meldung zurück und es wird kein Panel entfernt.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige Kennung (UUID) des Termins, aus dem Panels entfernt werden sollen.

### Body-Parameter

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

Array der Panel-UUIDs, die aus dem Termin entfernt werden sollen. Muss mindestens ein Element
enthalten. Ein Panel, das nicht verknüpft ist, wird ignoriert.

## Antwort

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

**success** `boolean`

`true`, wenn die Panels erfolgreich aus dem Termin entfernt 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` | Zugriff verweigert – dein API-Schlüssel hat keinen Zugriff auf diese Operation. |
| `404` | Termin nicht gefunden. |
| `409` | Konflikt – Panels können nicht mehr entfernt werden, nachdem die Blutabnahme bestätigt wurde. |
| `500` | Interner Serverfehler. |

```bash cURL theme={null}
curl --request DELETE \
  --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"
    ]
  }'
```

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

```json 409 theme={null}
{
  "error": "Panels cannot be removed after blood draw has been confirmed"
}
```

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


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