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

# Lisää yksittäisiä biomarkkereita

> Lisää yksittäisiä biomarkkereita kotitestipakkauksen tilaukseen

Lisää yksi tai useampi yksittäinen biomarkkeri olemassa olevaan kotitestipakkauksen tilaukseen valmiiden paneelien ulkopuolelta. Tämä päätepiste on idempotentti — jo liitetyt biomarkkerit säilytetään.

Vaatii `home_kit_orders_manage`-laajuuden sekä
`home_kit_orders_individual_biomarker_selection`-ominaisuuslaajuuden. Kotitestipakkaukset tilataan paneeleittain,
joten yksittäiset markkerit otetaan käyttöön kumppanikohtaisesti. Kysy Anivalta, jos integraatiosi tarvitsee sitä.

> [!WARNING]
>
> Biomarkkereita voi lisätä vain, kun pakkaus on tilassa `pending`. Kun pakkaus on tilassa `dispatched`,
> sen koostumus on lukittu ja tämä kutsu palauttaa `409 Conflict` — fyysinen pakkaus lähetetään valittujen
> paneelien ja biomarkkerien perusteella määritetyllä kiinteällä määrällä näyteputkia, joten sen sisältö ei voi
> muuttua lähettämisen jälkeen. Myös tilassa `activated` ja `cancelled` olevat pakkaukset on lukittu. Jos sinun täytyy
> muuttaa lukitun pakkauksen testejä, ota suoraan yhteyttä Anivaan — se on yleensä yhä mahdollista, ja
> teemme muutoksen puolestasi, jotta pakkauksen sisältö pysyy yhtenäisenä.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Sen kotitestipakkauksen tilauksen yksilöllinen tunniste (UUID), johon biomarkkerit lisätään.

### Runkoparametrit

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

Taulukko kotitestipakkauksen tilaukseen lisättävistä biomarkkeritunnisteista. Taulukossa on oltava vähintään yksi alkio. Hae
biomarkkeritunnisteet käyttämällä [Listaa biomarkkerit](https://docs.anivahealth.com/fi/api/biomarkers/list-biomarkers.md) -päätepistettä parametrilla `home_kit=true`.

## Vastaus

Onnistuessaan API palauttaa tilakoodin `200 OK` vahvistuksena biomarkkerien lisäämisestä.

**success** `boolean`

`true`, kun biomarkkerit on lisätty onnistuneesti kotitestipakkauksen tilaukseen.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Validointivirhe — esimerkiksi `biomarker_ids` on tyhjä tai sisältää virheellisen arvon. |
| `403` | Pääsy estetty — `home_kit_orders_manage` tai `home_kit_orders_individual_biomarker_selection`-ominaisuuslaajuus puuttuu, tai kotitestipakkauksen tilaus on käyttöoikeuslaajuutesi ulkopuolella. |
| `404` | Kotitestipakkauksen tilausta tai yhtä tai useampaa biomarkkeria ei löytynyt. |
| `409` | Ristiriita — pakkaus on tilassa `dispatched`, `activated` tai `cancelled`; sen paneeli- ja biomarkkerikoostumus on lukittu eikä sitä voi enää muuttaa. |
| `500` | Sisäinen palvelinvirhe. |

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