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

# Individuele biomarkers verwijderen

> Verwijder individuele biomarkers uit een afspraak

Verwijder een of meer individuele biomarkers uit de à-la-carteset van een afspraak.

De biomarkerset na verwijdering wordt gevalideerd tegen de sluitingsregels van elk lab: een
verwijdering kan de set ongeldig achterlaten (bijv. LDL verwijderen maar de LDL/HDL-ratio
behouden). In dat geval geeft het verzoek `400` terug met gestructureerde herstelopties en wordt
er niets verwijderd. Zie [Individuele biomarkers
toevoegen](https://docs.anivahealth.com/nl/api/appointments/add-individual-biomarkers.md) voor de structuur van de `validation`-payload.

Verwijderen is idempotent: biomarkers die niet zijn gekoppeld worden genegeerd in plaats van geweigerd. Zie [Idempotentie](https://docs.anivahealth.com/nl/concepts/idempotency.md).

Vereist de scope `appointments_schedule` of `appointments_manage`, plus `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Biomarkers kunnen niet meer worden verwijderd nadat je [Bloedafname
> bevestigen](https://docs.anivahealth.com/nl/api/appointments/confirm-blood-draw.md) hebt aangeroepen.

## Verzoek

### Padparameters

**id** `string` *required*

Unieke identifier (UUID) van de afspraak.

### Bodyparameters

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

Array van biomarker-ID's om los te koppelen. Moet ten minste één item bevatten. Een ID dat niet
bij de afspraak hoort, wordt genegeerd.

## Respons

**success** `boolean`

`true` wanneer de biomarkers succesvol zijn verwijderd.

## Foutresponsen

Verwijderen geeft nooit `biomarker_not_priced` terug. De prijs van een marker hangt niet af van de
rest van de set. Een set die al een niet-geprijsde marker bevat, blijft bewerkbaar. Zie [Individuele
biomarkers toevoegen](https://docs.anivahealth.com/nl/api/appointments/add-individual-biomarkers.md).

| Status | Beschrijving |
| - | - |
| `400` | `biomarker_ids` leeg / geen geheel getal, de set na verwijdering voldoet niet aan de sluitingsvalidatie (`validation.failures`), of de verwijdering zou een biomarker achterlaten die alleen binnen een positie wordt verkocht (`error: "biomarker_requires_position"`). |
| `403` | Verboden — ontbrekende scope of afspraak buiten toegangscontext. |
| `404` | Afspraak niet gevonden. |
| `409` | Conflict — biomarkers kunnen niet worden gewijzigd nadat de bloedafname is bevestigd. |
| `500` | Interne serverfout. |

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