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

# Egyedi biomarkerek eltávolítása

> Távolíts el külön választható biomarkereket egy otthoni tesztkészlet-rendelésből

Távolíts el egy vagy több egyedi biomarkert egy meglévő otthoni tesztkészlet-rendelésből. Az eltávolítás idempotens: a nem csatolt biomarkereket a rendszer figyelmen kívül hagyja, nem utasítja el. Lásd: [Idempotencia](https://docs.anivahealth.com/hu/concepts/idempotency.md).

Szükséges hozzá a `home_kit_orders_manage` scope és a
`home_kit_orders_individual_biomarker_selection` képesség-scope. Az otthoni tesztkészleteket panelenként lehet rendelni,
így az egyedi markereket partnerenként engedélyezzük. Kérd az Anivától, ha az integrációdnak szüksége van rá.

> [!WARNING]
>
> Biomarkereket csak addig lehet eltávolítani, amíg a tesztkészlet `pending` állapotú. Amint a tesztkészlet `dispatched` állapotba kerül, az
> összetétele zárolódik, és ez a hívás `409 Conflict` választ ad vissza — a fizikai tesztkészletet a kiválasztott panelek és biomarkerek alapján
> meghatározott, rögzített számú csővel szállítjuk ki, így a tartalma az elküldés után már nem
> változhat. Az `activated` és `cancelled` állapotú tesztkészletek szintén zároltak. Ha egy zárolt
> tesztkészlet vizsgálatait módosítanod kell, keresd közvetlenül az Anivát — ez általában még lehetséges, és
> mi elvégezzük helyetted a módosítást, hogy a tesztkészlet tartalma konzisztens maradjon.

## Kérés

### Útvonalparaméterek

**id** `string` *required*

Annak az otthoni tesztkészlet-rendelésnek az egyedi azonosítója (UUID), amelyből a biomarkereket eltávolítod.

### Törzsparaméterek

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

Az otthoni tesztkészlet-rendelésből eltávolítandó biomarker-azonosítók tömbje. Legalább egy elemet kell tartalmaznia.

## Válasz

Sikeres kérés esetén az API `200 OK` válasszal igazolja vissza a biomarkerek eltávolítását.

**success** `boolean`

`true`, ha sikerült eltávolítani a biomarkereket az otthoni tesztkészlet-rendelésből.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Validációs hiba – pl. a `biomarker_ids` üres vagy érvénytelen értéket tartalmaz. |
| `403` | Tiltott – hiányzik a `home_kit_orders_manage` vagy a `home_kit_orders_individual_biomarker_selection` jogosultsági scope, vagy az otthoni tesztkészlet-rendelés kívül esik a jogosultsági körödön. |
| `404` | Az otthoni tesztkészlet-rendelés nem található. |
| `409` | Ütközés – a készlet `dispatched`, `activated` vagy `cancelled` állapotú; a panelje és a biomarker-összetétele zárolva van, és már nem módosítható. |
| `409` | Ütközés – csak ezeket a markereket vizsgálja újra egy cserekészlet; eltávolításukkal nem maradna mit megrendelni. |
| `500` | Belső szerverhiba. |

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