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

# Poista yksittäisiä biomarkkereita

> Poista yksittäisiä biomarkkereita kotitestipakkauksen tilauksesta

Poista yksi tai useampi yksittäinen biomarkkeri olemassa olevasta kotitestipakkaustilauksesta. Poistaminen on idempotenttia: biomarkkerit, joita ei ole liitetty, ohitetaan hylkäämisen sijaan. Katso [Idempotenssi](https://docs.anivahealth.com/fi/concepts/idempotency.md).

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 poistaa vain, kun pakkaus on tilassa `pending`. Kun pakkaus on tilassa `dispatched`, sen
> kokoonpano on lukittu ja tämä kutsu palauttaa vastauksen `409 Conflict` — fyysinen pakkaus lähetetään valittujen
> paneelien ja biomarkkerien perusteella määräytyvällä kiinteällä määrällä näyteputkia, joten sen sisältöä ei voi muuttaa
> lähettämisen jälkeen. Myös tiloissa `activated` ja `cancelled` olevat pakkaukset on lukittu. Jos sinun täytyy
> muuttaa lukitun pakkauksen testejä, ota suoraan yhteyttä Anivaan — se on yleensä edelleen mahdollista, ja
> teemme muutoksen puolestasi, jotta pakkauksen sisältö pysyy yhdenmukaisena.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Sen kotitestipakkaustilauksen yksilöllinen tunniste (UUID), josta biomarkkerit poistetaan.

### Runkoparametrit

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

Taulukko kotitestipakkaustilauksesta poistettavien biomarkkereiden tunnisteista. Taulukon täytyy sisältää vähintään yksi alkio.

## Vastaus

Onnistuessaan API palauttaa `200 OK` vahvistuksena siitä, että biomarkkerit on poistettu.

**success** `boolean`

`true`, kun biomarkkerit on poistettu onnistuneesti kotitestipakkaustilauksesta.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Validointivirhe — esim. `biomarker_ids` on tyhjä tai sisältää virheellisen arvon. |
| `403` | Kielletty — `home_kit_orders_manage`-käyttöoikeus tai `home_kit_orders_individual_biomarker_selection`-ominaisuusoikeus puuttuu, tai kotitestipakkaustilaus ei kuulu käyttöoikeuksiisi. |
| `404` | Kotitestipakkaustilausta ei löytynyt. |
| `409` | Ristiriita — pakkaus on tilassa `dispatched`, `activated` tai `cancelled`; sen paneeli ja biomarkkerikoostumus on lukittu eikä niitä voi enää muuttaa. |
| `409` | Ristiriita — nämä ovat ainoat markkerit, jotka korvaava pakkaus testaa uudelleen; niiden poistaminen ei jättäisi mitään tilattavaa. |
| `500` | Sisäinen palvelinvirhe. |

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