> ## 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 einer Heimtest-Kit-Bestellung entfernen

Entferne einen oder mehrere Einzel-Biomarker aus einer bestehenden Heimtest-Kit-Bestellung. Das Entfernen ist idempotent: Nicht zugeordnete Biomarker werden ignoriert statt abgelehnt. Siehe [Idempotenz](https://docs.anivahealth.com/de/concepts/idempotency.md).

Erfordert den Scope `home_kit_orders_manage` sowie den
Capability-Scope `home_kit_orders_individual_biomarker_selection`. Heimtest-Kits werden nach Panel bestellt,
daher werden einzelne Marker pro Partner freigeschaltet. Frag bei Aniva nach, wenn deine Integration das braucht.

> [!WARNING]
>
> Biomarker können nur entfernt werden, solange das Kit den Status `pending` hat. Sobald das Kit `dispatched` ist, ist seine
> Zusammensetzung gesperrt und dieser Aufruf gibt `409 Conflict` zurück – das physische Kit wird mit einer festen
> Anzahl an Röhrchen verschickt, die sich aus den ausgewählten Panels und Biomarkern ergibt, sodass sich sein Inhalt nach dem Versand nicht mehr ändern
> kann. Kits mit dem Status `activated` und `cancelled` sind ebenfalls gesperrt. Wenn du die
> Tests eines gesperrten Kits ändern musst, wende dich direkt an Aniva – das ist meistens noch möglich, und
> wir nehmen die Änderung für dich vor, damit der Inhalt des Kits konsistent bleibt.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige Kennung (UUID) der Heimtest-Kit-Bestellung, aus der Biomarker entfernt werden sollen.

### Body-Parameter

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

Array von Biomarker-IDs, die aus der Heimtest-Kit-Bestellung entfernt werden sollen. Muss mindestens einen Eintrag enthalten.

## Antwort

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

**success** `boolean`

`true`, wenn die Biomarker erfolgreich aus der Heimtest-Kit-Bestellung entfernt wurden.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Validierungsfehler – z. B. ist `biomarker_ids` leer oder enthält einen ungültigen Wert. |
| `403` | Zugriff verweigert – der Scope `home_kit_orders_manage` oder der Capability-Scope `home_kit_orders_individual_biomarker_selection` fehlt, oder die Heimtest-Kit-Bestellung liegt außerhalb deines Berechtigungsbereichs. |
| `404` | Heimtest-Kit-Bestellung nicht gefunden. |
| `409` | Konflikt – das Kit hat den Status `dispatched`, `activated` oder `cancelled`; sein Panel und seine Biomarker-Zusammensetzung sind gesperrt und können nicht mehr geändert werden. |
| `409` | Konflikt – das sind die einzigen Marker, die ein Ersatz-Kit erneut testet; würden sie entfernt, bliebe nichts zu bestellen. |
| `500` | Interner Serverfehler. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/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": "Home kit order not found"
}
```


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