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

# Rimuovi singoli biomarcatori

> Rimuovi singoli biomarcatori da un appuntamento

Rimuovi uno o più biomarcatori singoli dal set à la carte di un appuntamento.

Il set di biomarcatori risultante viene validato rispetto alle regole di chiusura di ciascun
laboratorio: una rimozione può lasciare il set incompleto (ad es. eliminando LDL ma mantenendo il
rapporto LDL/HDL). In questo caso, la richiesta restituisce `400` con opzioni strutturate di
ripristino e nulla viene rimosso. Consulta [Aggiungi biomarcatori
singoli](https://docs.anivahealth.com/it/api/appointments/add-individual-biomarkers.md) per la struttura del payload `validation`.

La rimozione è idempotente: i biomarcatori non associati vengono ignorati anziché rifiutati. Consulta [Idempotenza](https://docs.anivahealth.com/it/concepts/idempotency.md).

Richiede lo scope `appointments_schedule` o `appointments_manage`, oltre a `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Non puoi rimuovere i biomarcatori dopo aver chiamato [Conferma prelievo di
> sangue](https://docs.anivahealth.com/it/api/appointments/confirm-blood-draw.md).

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore univoco (UUID) dell'appuntamento.

### Parametri del body

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

Array di ID di biomarcatori da scollegare. Deve contenere almeno un elemento. Un ID non presente
nell'appuntamento viene ignorato.

## Risposta

**success** `boolean`

`true` quando i biomarcatori sono stati rimossi correttamente.

## Risposte di errore

La rimozione non restituisce mai `biomarker_not_priced`. Il prezzo di un marcatore non dipende dal
resto del set. Un set che contiene già un marcatore senza prezzo resta modificabile. Consulta
[Aggiungi biomarcatori singoli](https://docs.anivahealth.com/it/api/appointments/add-individual-biomarkers.md).

| Stato | Descrizione |
| - | - |
| `400` | `biomarker_ids` vuoto o non intero, il set risultante non supera la validazione di chiusura (`validation.failures`), oppure la rimozione lascerebbe isolato un biomarcatore venduto solo all'interno di una posizione (`error: "biomarker_requires_position"`). |
| `403` | Accesso negato — scope mancante o appuntamento al di fuori del contesto di accesso. |
| `404` | Appuntamento non trovato. |
| `409` | Conflitto — i biomarcatori non possono essere modificati dopo la conferma del prelievo di sangue. |
| `500` | Errore interno del server. |

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