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

# Usuń pojedyncze biomarkery

> Usuń pojedyncze biomarkery z zamówienia domowego zestawu testowego

Usuń jeden lub więcej pojedynczych biomarkerów z istniejącego zamówienia domowego zestawu testowego. Usuwanie jest idempotentne: biomarkery, które nie są przypisane, są ignorowane, a nie odrzucane. Zobacz [Idempotentność](https://docs.anivahealth.com/pl/concepts/idempotency.md).

Wymaga zakresu `home_kit_orders_manage` oraz zakresu funkcjonalnego
`home_kit_orders_individual_biomarker_selection`. Domowe zestawy testowe zamawia się według paneli,
więc pojedyncze markery są włączane dla poszczególnych partnerów. Zapytaj Aniva, jeśli twoja integracja tego potrzebuje.

> [!WARNING]
>
> Biomarkery można usunąć tylko wtedy, gdy zestaw ma status `pending`. Gdy zestaw ma status `dispatched`, jego
> skład jest zablokowany, a to wywołanie zwraca `409 Conflict` — fizyczny zestaw jest wysyłany ze stałą
> liczbą probówek wynikającą z wybranych paneli i biomarkerów, więc jego zawartość nie może się zmienić
> po wysłaniu. Zestawy ze statusem `activated` i `cancelled` są również zablokowane. Jeśli musisz
> zmienić badania w zablokowanym zestawie, skontaktuj się bezpośrednio z Aniva — zazwyczaj jest to nadal możliwe i
> wprowadzimy zmianę za ciebie, aby zawartość zestawu pozostała spójna.

## Żądanie

### Parametry ścieżki

**id** `string` *required*

Unikalny identyfikator (UUID) zamówienia domowego zestawu testowego, z którego chcesz usunąć biomarkery.

### Parametry treści

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

Tablica identyfikatorów biomarkerów do usunięcia z zamówienia domowego zestawu testowego. Musi zawierać co najmniej jeden element.

## Odpowiedź

W przypadku powodzenia API zwraca `200 OK` z potwierdzeniem usunięcia biomarkerów.

**success** `boolean`

`true`, gdy biomarkery zostały pomyślnie usunięte z zamówienia domowego zestawu testowego.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — np. `biomarker_ids` jest puste lub zawiera nieprawidłową wartość. |
| `403` | Brak dostępu — brak zakresu `home_kit_orders_manage` lub zakresu funkcji `home_kit_orders_individual_biomarker_selection`, albo zamówienie domowego zestawu testowego jest poza zakresem twoich uprawnień. |
| `404` | Nie znaleziono zamówienia domowego zestawu testowego. |
| `409` | Konflikt — zestaw ma status `dispatched`, `activated` lub `cancelled`; jego panel i skład biomarkerów są zablokowane i nie można ich już zmienić. |
| `409` | Konflikt — to jedyne markery powtarzane w zestawie zastępczym; ich usunięcie nie pozostawiłoby niczego do zamówienia. |
| `500` | Wewnętrzny błąd serwera. |

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