> ## 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 hinzufügen

> Einzelne Biomarker zu einer Heimtest-Kit-Bestellung hinzufügen

Füge einer bestehenden Heimtest-Kit-Bestellung einen oder mehrere frei wählbare Biomarker hinzu, außerhalb eines vorgefertigten Panels. Dieser Endpunkt ist idempotent – bereits zugeordnete Biomarker bleiben erhalten.

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 hinzugefügt werden, solange das Kit `pending` ist. 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 der Inhalt nach
> dem Versand nicht mehr ändern lässt. Kits mit dem Status `activated` und `cancelled` sind ebenfalls gesperrt. Wenn du
> die Tests für ein gesperrtes Kit ändern musst, melde dich direkt bei Aniva – meistens ist das 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, der Biomarker hinzugefügt werden sollen.

### Body-Parameter

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

Array von Biomarker-IDs, die der Heimtest-Kit-Bestellung hinzugefügt werden sollen. Muss mindestens ein Element enthalten. Nutze
[Biomarker auflisten](https://docs.anivahealth.com/de/api/biomarkers/list-biomarkers.md) mit `home_kit=true`, um Biomarker-IDs abzurufen.

## Antwort

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

**success** `boolean`

`true`, wenn die Biomarker erfolgreich zur Heimtest-Kit-Bestellung hinzugefügt 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 oder ein oder mehrere Biomarker nicht gefunden. |
| `409` | Konflikt – das Kit hat den Status `dispatched`, `activated` oder `cancelled`; seine Panel- und Biomarker-Zusammensetzung ist gesperrt und kann nicht mehr geändert werden. |
| `500` | Interner Serverfehler. |

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

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

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


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