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

# Ajouter des biomarqueurs individuels

> Ajouter des biomarqueurs à la carte à une commande de kit à domicile

Ajouter un ou plusieurs biomarqueurs à la carte à une commande de kit à domicile existante, en dehors de tout panel prédéfini. Ce point de terminaison est idempotent — les biomarqueurs déjà associés sont conservés.

Requiert le scope `home_kit_orders_manage` ainsi que le
scope de capacité `home_kit_orders_individual_biomarker_selection`. Les kits à domicile se commandent par panel,
donc les marqueurs individuels sont activés par partenaire. Demande à Aniva si ton intégration en a besoin.

> [!WARNING]
>
> Les biomarqueurs ne peuvent être ajoutés que tant que le kit est `pending`. Une fois le kit `dispatched`, sa
> composition est verrouillée et cet appel renvoie `409 Conflict` — le kit physique est expédié avec un nombre fixe
> de tubes déterminé par les panels et biomarqueurs sélectionnés, donc son contenu ne peut plus changer
> après l'envoi. Les kits `activated` et `cancelled` sont également verrouillés. Si tu dois
> modifier les analyses d'un kit verrouillé, contacte directement Aniva — c'est généralement encore possible, et
> nous effectuerons le changement pour toi afin de garder le contenu du kit cohérent.

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant unique (UUID) de la commande de kit à domicile à laquelle ajouter des biomarqueurs.

### Paramètres du corps

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

Tableau d'identifiants de biomarqueurs à ajouter à la commande de kit à domicile. Doit contenir au moins un élément. Utilise
[Lister les biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md) avec `home_kit=true` pour trouver les identifiants de biomarqueurs.

## Réponse

En cas de succès, l'API renvoie `200 OK` confirmant que les biomarqueurs ont été ajoutés.

**success** `boolean`

`true` lorsque les biomarqueurs ont bien été ajoutés à la commande de kit à domicile.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Erreur de validation — par ex., `biomarker_ids` est vide ou contient une valeur invalide. |
| `403` | Accès refusé — scope `home_kit_orders_manage` ou scope de capacité `home_kit_orders_individual_biomarker_selection` manquant, ou la commande de kit à domicile est hors de ton périmètre d'autorisations. |
| `404` | Commande de kit à domicile ou un ou plusieurs biomarqueurs introuvables. |
| `409` | Conflit — le kit est `dispatched`, `activated` ou `cancelled` ; sa composition en panels et biomarqueurs est verrouillée et ne peut plus changer. |
| `500` | Erreur interne du serveur. |

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