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

Poista yksi tai useampi yksittäinen biomarkkeri ajanvarauksen à la carte -valikoimasta.

Poiston jälkeinen biomarkkerijoukko validoidaan kunkin laboratorion sulkeumasääntöjä vasten:
poisto voi jättää joukon epätäydelliseksi (esim. jos LDL poistetaan mutta LDL/HDL-suhdeluku
säilytetään). Jos näin käy, pyyntö palauttaa koodin `400` ja jäsennellyt korjausvaihtoehdot,
eikä mitään poisteta. Katso `validation`-sisällön rakenne sivulta [Lisää yksittäisiä
biomarkkereita](https://docs.anivahealth.com/fi/api/appointments/add-individual-biomarkers.md).

Poisto on idempotentti: biomarkkerit, joita ei ole liitetty, ohitetaan hylkäämisen sijaan. Katso [Idempotenssi](https://docs.anivahealth.com/fi/concepts/idempotency.md).

Vaatii käyttöoikeuden `appointments_schedule` tai `appointments_manage` sekä `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Biomarkkereita ei voi poistaa sen jälkeen, kun olet kutsunut päätepistettä [Vahvista
> verinäytteenotto](https://docs.anivahealth.com/fi/api/appointments/confirm-blood-draw.md).

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Ajanvarauksen yksilöllinen tunniste (UUID).

### Runkoparametrit

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

Taulukko irrotettavien biomarkkereiden tunnisteista. Täytyy sisältää vähintään yksi alkio.
Tunniste, jota ei ole ajanvarauksessa, ohitetaan.

## Vastaus

**success** `boolean`

`true`, kun biomarkkerit on poistettu onnistuneesti.

## Virhevastaukset

Poisto ei koskaan palauta virhettä `biomarker_not_priced`. Markkerin hinta ei riipu muusta
joukosta. Joukko, jossa on jo hinnoittelematon markkeri, pysyy muokattavana. Katso [Lisää
yksittäisiä biomarkkereita](https://docs.anivahealth.com/fi/api/appointments/add-individual-biomarkers.md).

| Tila | Kuvaus |
| - | - |
| `400` | `biomarker_ids` on tyhjä / ei ole kokonaisluku, poiston jälkeinen joukko ei läpäise sulkeumavalidointia (`validation.failures`) tai poisto jättäisi irralliseksi biomarkkerin, jota myydään vain position sisällä (`error: "biomarker_requires_position"`). |
| `403` | Estetty — puuttuva käyttöoikeus tai ajanvaraus käyttöoikeuskontekstin ulkopuolella. |
| `404` | Ajanvarausta ei löytynyt. |
| `409` | Ristiriita — biomarkkereita ei voi muokata verinäytteenoton vahvistamisen jälkeen. |
| `500` | Sisäinen palvelinvirhe. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/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": "Appointment not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.