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

> Poista verikoepaneeleja ajanvarauksesta

Poista yksi tai useampi verikoepaneeli olemassa olevasta ajanvarauksesta. Tämä poistaa määritettyihin paneeleihin liittyvät suunnitellut testien tilannekuvat.

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

Vaatii `appointments_schedule`- tai `appointments_manage`-käyttöoikeuden.

> [!WARNING]
>
> Paneeleja 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). Yritys poistaa paneeleja vahvistetusta
> ajanvarauksesta palauttaa virheen `409 Conflict`.

Kapillaarinäytteenotossa (`draw_method: capillary`) yksittäiset biomarkkerit pakataan mikroputkiin
yhdessä paneelien kanssa. Jos jäljelle jäävä joukko rikkoo sivun [Lisää yksittäisiä
biomarkkereita](https://docs.anivahealth.com/fi/api/appointments/add-individual-biomarkers.md) 150 µl:n sääntöä, kutsu palauttaa
koodin `400` ja `error`-viestin, eikä yhtään paneelia poisteta.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Sen ajanvarauksen yksilöllinen tunniste (UUID), josta paneelit poistetaan.

### Runkoparametrit

**panel\_ids** `string[]` *required*

Taulukko ajanvarauksesta poistettavien paneelien UUID-tunnisteista. Täytyy sisältää vähintään
yksi alkio. Paneeli, jota ei ole liitetty, ohitetaan.

## Vastaus

Onnistuessaan API palauttaa vastauksen `200 OK`, joka vahvistaa paneelien poistamisen.

**success** `boolean`

`true`, kun paneelit on poistettu ajanvarauksesta onnistuneesti.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Validointivirhe — esim. `panel_ids` on tyhjä tai sisältää virheellisen UUID-tunnisteen — tai kapillaarinäytteenotossa yksittäiset biomarkkerit eivät enää mahdu mikroputkiinsa. |
| `403` | Estetty — API-avaimellasi ei ole oikeutta tähän toimintoon. |
| `404` | Ajanvarausta ei löytynyt. |
| `409` | Ristiriita — paneeleja ei voi poistaa 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/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9"
    ]
  }'
```

```json 200 theme={null}
{
  "success": true
}
```

```json 409 theme={null}
{
  "error": "Panels cannot be removed after blood draw has been confirmed"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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