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

# Dodaj pojedyncze biomarkery

> Dodaj pojedyncze biomarkery do zamówienia domowego zestawu testowego

Dodaj jeden lub więcej pojedynczych biomarkerów do istniejącego zamówienia domowego zestawu testowego, poza gotowym panelem. Ten endpoint jest idempotentny — już dołączone biomarkery zostają zachowane.

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 dodawać tylko wtedy, gdy zestaw ma status `pending`. Gdy zestaw otrzyma status `dispatched`, jego
> skład zostaje zablokowany, a to wywołanie zwraca `409 Conflict` — fizyczny zestaw jest wysyłany ze stałą
> liczbą probówek dobraną do wybranych paneli i biomarkerów, więc jego zawartości nie można zmienić
> po wysyłce. 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 jeszcze możliwe,
> a my wprowadzimy zmianę za ciebie, żeby zawartość zestawu pozostała spójna.

## Żądanie

### Parametry ścieżki

**id** `string` *required*

Unikalny identyfikator (UUID) zamówienia domowego zestawu testowego, do którego chcesz dodać biomarkery.

### Parametry treści

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

Tablica identyfikatorów biomarkerów do dodania do zamówienia domowego zestawu testowego. Musi zawierać co najmniej jeden element. Użyj
[Wyświetl biomarkery](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md) z `home_kit=true`, aby znaleźć identyfikatory biomarkerów.

## Odpowiedź

W razie powodzenia API zwraca `200 OK` z potwierdzeniem, że biomarkery zostały dodane.

**success** `boolean`

`true`, gdy biomarkery zostały pomyślnie dodane do zamówienia domowego zestawu testowego.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — np. tablica `biomarker_ids` jest pusta lub zawiera nieprawidłową wartość. |
| `403` | Brak dostępu — brakuje zakresu `home_kit_orders_manage` albo zakresu funkcjonalnego `home_kit_orders_individual_biomarker_selection` lub zamówienie domowego zestawu testowego wykracza poza zakres twoich uprawnień. |
| `404` | Nie znaleziono zamówienia domowego zestawu testowego albo jednego lub więcej biomarkerów. |
| `409` | Konflikt — zestaw ma status `dispatched`, `activated` lub `cancelled`; skład jego paneli i biomarkerów jest zablokowany i nie można go już zmienić. |
| `500` | Wewnętrzny błąd serwera. |

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