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

# Přidat jednotlivé biomarkery

> Přidat jednotlivé biomarkery do objednávky domácí testovací sady

Přidej jeden nebo více samostatných biomarkerů k existující objednávce domácí testovací sady mimo předpřipravený panel. Tento endpoint je idempotentní — už přidané biomarkery zůstanou.

Vyžaduje scope `home_kit_orders_manage` a doplňkový scope
`home_kit_orders_individual_biomarker_selection`. Domácí testovací sady se objednávají po panelech,
takže jednotlivé markery jsou povoleny pro každého partnera zvlášť. Kontaktuj Aniva, pokud to tvá integrace potřebuje.

> [!WARNING]
>
> Biomarkery lze přidávat jen tehdy, když je sada ve stavu `pending`. Jakmile má sada stav `dispatched`, její
> složení se uzamkne a toto volání vrátí `409 Conflict` — fyzická sada se posílá s pevným
> počtem zkumavek podle vybraných panelů a biomarkerů, takže její obsah po odeslání nejde
> změnit. Uzamčené jsou i sady ve stavu `activated` a `cancelled`. Pokud potřebuješ
> změnit testy u uzamčené sady, kontaktuj přímo Aniva — obvykle to ještě jde a
> změnu provedeme za tebe, aby obsah sady zůstal konzistentní.

## Požadavek

### Parametry cesty

**id** `string` *required*

Jedinečný identifikátor (UUID) objednávky domácí testovací sady, ke které chceš přidat biomarkery.

### Parametry těla

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

Pole identifikátorů biomarkerů, které chceš přidat k objednávce domácí testovací sady. Musí obsahovat alespoň jednu položku. ID biomarkerů zjistíš přes
[Seznam biomarkerů](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md) s `home_kit=true`.

## Odpověď

Při úspěchu API vrátí `200 OK` s potvrzením, že biomarkery byly přidány.

**success** `boolean`

`true`, když byly biomarkery úspěšně přidány k objednávce domácí testovací sady.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Chyba validace — např. `biomarker_ids` je prázdné nebo obsahuje neplatnou hodnotu. |
| `403` | Přístup odepřen — chybí `home_kit_orders_manage` nebo doplňkový scope `home_kit_orders_individual_biomarker_selection`, případně objednávka domácí testovací sady spadá mimo rozsah tvých oprávnění. |
| `404` | Objednávka domácí testovací sady nebo jeden či více biomarkerů nenalezeny. |
| `409` | Konflikt — sada má stav `dispatched`, `activated` nebo `cancelled`; její složení panelu a biomarkerů je uzamčené a už ho nelze změnit. |
| `500` | Interní chyba serveru. |

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