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

# Einzelne Biomarker entfernen

> Einzelne Biomarker aus einem Termin entfernen

Entferne einen oder mehrere einzelne Biomarker aus der À-la-carte-Auswahl eines Termins.

Das Biomarker-Set nach dem Entfernen wird anhand der Vollständigkeitsregeln jedes Labors validiert:
Ein Entfernen kann das Set unvollständig zurücklassen (z. B. wenn LDL entfernt, das
LDL/HDL-Verhältnis aber beibehalten wird). Ist das der Fall, gibt die Anfrage `400` mit
strukturierten Korrekturoptionen zurück und es wird nichts entfernt. Siehe [Einzelne Biomarker
hinzufügen](https://docs.anivahealth.com/de/api/appointments/add-individual-biomarkers.md) für die Struktur der `validation`-Payload.

Das Entfernen ist idempotent: Biomarker, 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` sowie `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Biomarker können nicht mehr entfernt werden, nachdem du [Blutabnahme
> bestätigen](https://docs.anivahealth.com/de/api/appointments/confirm-blood-draw.md) aufgerufen hast.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige Kennung (UUID) des Termins.

### Body-Parameter

**biomarker\_ids** `number[]` *required*

Array der zu entfernenden Biomarker-IDs. Muss mindestens ein Element enthalten. Eine ID, die nicht
im Termin enthalten ist, wird ignoriert.

## Antwort

**success** `boolean`

`true`, wenn die Biomarker erfolgreich entfernt wurden.

## Fehlerantworten

Das Entfernen gibt niemals `biomarker_not_priced` zurück. Der Preis eines Markers hängt nicht vom
Rest des Sets ab. Ein Set, das bereits einen Marker ohne Preis enthält, bleibt bearbeitbar. Siehe
[Einzelne Biomarker hinzufügen](https://docs.anivahealth.com/de/api/appointments/add-individual-biomarkers.md).

| Status | Beschreibung |
| - | - |
| `400` | `biomarker_ids` ist leer oder keine Ganzzahl, das Set nach dem Entfernen besteht die Vollständigkeitsvalidierung nicht (`validation.failures`) oder das Entfernen würde einen Biomarker allein zurücklassen, der nur innerhalb einer Position verkauft wird (`error: "biomarker_requires_position"`). |
| `403` | Zugriff verweigert – fehlender Scope oder Termin außerhalb des Zugriffskontexts. |
| `404` | Termin nicht gefunden. |
| `409` | Konflikt – Biomarker können nicht mehr geändert 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/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [42]
  }'
```

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

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


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