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

# Retirer des biomarqueurs individuels

> Retirer des biomarqueurs à la carte d'une commande de kit à domicile

Supprime un ou plusieurs biomarqueurs à la carte d'une commande de kit à domicile existante. La suppression est idempotente : les biomarqueurs qui ne sont pas associés sont ignorés plutôt que rejetés. Voir [Idempotence](https://docs.anivahealth.com/fr/concepts/idempotency.md).

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 supprimé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, son contenu ne peut donc plus changer
> après l'envoi. Les kits `activated` et `cancelled` sont également verrouillés. Si tu dois
> modifier les analyses sur un kit verrouillé, contacte directement Aniva — c'est généralement encore possible, et
> nous effectuerons le changement pour toi afin que le contenu du kit reste cohérent.

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant unique (UUID) de la commande de kit à domicile dont tu veux retirer des biomarqueurs.

### Paramètres du corps

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

Tableau d'identifiants de biomarqueurs à retirer de la commande de kit à domicile. Doit contenir au moins un élément.

## Réponse

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

**success** `boolean`

`true` lorsque les biomarqueurs ont bien été retirés de 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'autorisation. |
| `404` | Commande de kit à domicile introuvable. |
| `409` | Conflit — le kit est `dispatched`, `activated` ou `cancelled` ; son panel et sa composition en biomarqueurs sont verrouillés et ne peuvent plus changer. |
| `409` | Conflit — ce sont les seuls marqueurs qu'un kit de remplacement réanalyse ; les retirer ne laisserait rien à commander. |
| `500` | Erreur interne du serveur. |

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