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

# Irrota ajanvaraukset lähetyksestä

> Poista yksi tai useampi ajanvaraus lähetyksestä

Poista yksi tai useampi ajanvaraus tästä lähetyksestä. Ohittaa hiljaisesti ajanvaraukset, joita ei
ole tällä hetkellä liitetty.

Muokkaussääntö on sama kuin päätepisteessä [Liitä ajanvarauksia
lähetykseen](https://docs.anivahealth.com/fi/api/shipments/attach-appointments-to-shipment.md): liitoksen voi poistaa, kun JOKO
ajanvarauksen verinäytteenotto on jo ohi tai lähetys on luotu alle 24 tuntia sitten.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Lähetyksen viitetunnus (esim. `P2611194821`).

### Runkoparametrit

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

Taulukko irrotettavien ajanvarausten UUID-tunnuksista. Taulukossa on oltava vähintään yksi alkio.

## Vastaus

Onnistuessaan API palauttaa `200 OK` sekä pääsykontekstissasi olevat linkitetyt ajanvaraukset,
vanhin linkki ensin. Jokaisen tietueen rakenne vastaa päätepistettä [Hae ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/get-appointment.md).

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Validointivirhe — esim. tyhjä `appointment_ids` tai virheellinen UUID. |
| `403` | Kielletty — puuttuva scope, lähetys tai ajanvaraus on pääsykontekstin ulkopuolella, tai linkitetty kotitestipakettitilaus on pääsykontekstisi ulkopuolella. |
| `404` | Lähetystä ei löytynyt, tai yhtä tai useampaa ajanvarausta ei löytynyt. |
| `409` | Muutossääntö ei täyty — vähintään yksi ajanvaraus ei ole ohittanut verinäytteenottoa ja lähetys on yli 24 tuntia vanha. Vastaus listaa tunnisteet. |
| `500` | Sisäinen palvelinvirhe. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/shipments/P2611194821/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "appointment_ids": [
      "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a"
    ]
  }'
```

```json 200 theme={null}
[]
```


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