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

# Aggiungi singoli biomarcatori

> Aggiungi biomarcatori à la carte a un ordine di kit domiciliare

Aggiungi uno o più biomarcatori singoli a un ordine di kit domiciliare esistente, al di fuori di qualsiasi pannello predefinito. Questo endpoint è idempotente — i biomarcatori già associati vengono mantenuti.

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 aggiunti solo mentre il kit è `pending`. Una volta che il kit è `dispatched`, la sua
> composizione viene 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 la spedizione. 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 mantenere coerente il contenuto del kit.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore univoco (UUID) dell'ordine di kit domiciliare a cui aggiungere i biomarcatori.

### Parametri del body

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

Array di identificatori dei biomarcatori da aggiungere all'ordine di kit domiciliare. Deve contenere almeno un elemento. Usa
[Elenca biomarcatori](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md) con `home_kit=true` per trovare gli ID dei biomarcatori.

## Risposta

In caso di successo, l'API restituisce `200 OK` a conferma che i biomarcatori sono stati aggiunti.

**success** `boolean`

`true` quando i biomarcatori sono stati aggiunti correttamente all'ordine di kit domiciliare.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Errore di validazione — ad 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 di kit domiciliare è fuori dal tuo ambito di permessi. |
| `404` | Ordine di kit domiciliare o uno o più biomarcatori non trovati. |
| `409` | Conflitto — il kit è `dispatched`, `activated` o `cancelled`; la sua composizione di pannelli e biomarcatori è bloccata e non può più cambiare. |
| `500` | Errore interno del server. |

```bash cURL theme={null}
curl --request PATCH \
  --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, 87]
  }'
```

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

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


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