> ## 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 biomarcatori à la carte da un ordine di kit domiciliare

Rimuovi uno o più biomarcatori singoli da un ordine di kit domiciliare esistente. La rimozione è idempotente: i biomarcatori non associati vengono ignorati anziché rifiutati. Vedi [Idempotenza](https://docs.anivahealth.com/it/concepts/idempotency.md).

Richiede lo scope `home_kit_orders_manage` più lo scope di funzionalità
`home_kit_orders_individual_biomarker_selection`. I kit domiciliari si ordinano per pannello,
quindi i singoli marcatori vengono abilitati per partner. Chiedi ad Aniva se la tua integrazione ne ha bisogno.

> [!WARNING]
>
> I biomarcatori possono essere rimossi solo mentre il kit è `pending`. Una volta che il kit è `dispatched`, la sua
> composizione è bloccata e questa chiamata restituisce `409 Conflict` — il kit fisico viene spedito con un numero
> fisso di provette determinato dai pannelli e dai biomarcatori selezionati, quindi il suo contenuto non può cambiare
> dopo l'invio. Anche i kit `activated` e `cancelled` sono bloccati. Se devi
> modificare gli esami di un kit bloccato, contatta direttamente Aniva — di solito è ancora possibile e
> faremo noi la modifica per te per mantenere coerente il contenuto del kit.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificativo univoco (UUID) dell'ordine del kit domiciliare da cui rimuovere i biomarcatori.

### Parametri del body

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

Array di identificativi dei biomarcatori da rimuovere dall'ordine del kit domiciliare. Deve contenere almeno un elemento.

## Risposta

In caso di successo, l'API restituisce `200 OK` confermando che i biomarcatori sono stati rimossi.

**success** `boolean`

`true` quando i biomarcatori sono stati rimossi correttamente dall'ordine del kit domiciliare.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Errore di validazione — es. `biomarker_ids` è vuoto o contiene un valore non valido. |
| `403` | Accesso negato — manca lo scope `home_kit_orders_manage` o lo scope di funzionalità `home_kit_orders_individual_biomarker_selection`, oppure l'ordine del kit domiciliare è fuori dal tuo ambito di autorizzazione. |
| `404` | Ordine del kit domiciliare non trovato. |
| `409` | Conflitto — il kit è `dispatched`, `activated` o `cancelled`; il suo pannello e la composizione dei biomarcatori sono bloccati e non possono più cambiare. |
| `409` | Conflitto — questi sono gli unici marcatori che un kit sostitutivo ripete; rimuoverli non lascerebbe nulla da ordinare. |
| `500` | Errore interno del server. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/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": "Home kit order not found"
}
```


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