> ## 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 individuels à un rendez-vous

Ajoute un ou plusieurs biomarqueurs individuels à un rendez-vous comme analyses à la carte, en dehors
de tout panel préconstruit. Les décisions de routage sont prises en aval par le pipeline logistique des commandes selon
les correspondances par laboratoire de chaque biomarqueur.

L'ensemble obtenu est validé de manière synchrone selon les règles de clôture de chaque laboratoire. Certains biomarqueurs
ne peuvent être obtenus qu'en les commandant avec d'autres — un rapport LDL/HDL, par exemple, est
fourni par une commande qui renvoie aussi LDL et HDL, donc demander le rapport seul ne constitue pas une
commande cohérente. (Ce sont ces mêmes composants qui déterminent le *prix* du rapport — consulte le détail de `pricing`
sur [Lister les biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md).) Quand l'ensemble ne peut pas être commandé
proprement, l'appel renvoie `400` avec un payload `validation` et **rien n'est enregistré**, ce qui te permet
de procéder par essais et erreurs jusqu'à obtenir un ensemble valide :

1. `PATCH … { "biomarker_ids": [45] }` (rapport LDL/HDL seul) → `400` ;
   `validation.failures[].fix_options[].add_biomarkers` liste LDL et HDL.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (rapport + LDL + HDL) → `200`.

La même boucle couvre les biomarqueurs qu'Aniva ne vend qu'au sein d'une position : demande-en un seul et l'appel
renvoie `400` avec `error: "biomarker_requires_position"` et les positions qui le vendent. Consulte
[Tarification](https://docs.anivahealth.com/fr/concepts/pricing.md).

[Lister les biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md) indique `price_cents: null` pour certains biomarqueurs.
Ces biomarqueurs sont **non configurés** : Aniva n'a pas fixé leur prix. Si tu en ajoutes un, l'appel renvoie
`400` avec `error: "biomarker_not_priced"`. Aucun autre biomarqueur ne corrige cette erreur, car `null`
signifie que tu n'as aucun prix pour acheter ce marqueur. Les marqueurs de kit font exception. Ajoute le panel
correspondant au kit, et ses membres sont inclus avec le panel. L'appel accepte aussi un membre que tu ajoutes à
un rendez-vous qui comporte déjà ce panel.

Lors d'une prise de sang capillaire (`draw_method: capillary`), le prélèvement est réparti dans des microtainers. Les panels passent en premier, dans
l'ordre de réservation. Les biomarqueurs individuels remplissent ensuite l'espace libre des microtainers des panels. Quand ils
ont besoin de plus de place, ils ouvrent de nouveaux microtainers. Nous les répartissons équitablement. Chaque microtainer contient au maximum
150 µl de biomarqueurs individuels. Un biomarqueur qui nécessite plus de 150 µl dans un microtainer à lui seul ne rentre
jamais, tout comme un biomarqueur sans volume renseigné. Si l'ensemble obtenu enfreint cette règle,
l'appel renvoie `400` avec un message `error` et rien n'est enregistré.

Cet appel est idempotent : les biomarqueurs déjà présents sur le rendez-vous sont conservés.

Nécessite les scopes `appointments_schedule` et `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Tu ne peux plus ajouter de biomarqueurs après avoir appelé [Confirmer la prise de
> sang](https://docs.anivahealth.com/fr/api/appointments/confirm-blood-draw.md). Toute tentative de modification d'un rendez-vous confirmé renvoie
> `409 Conflict`.

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant unique (UUID) du rendez-vous.

### Paramètres du corps

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

Tableau d'ID de biomarqueurs à ajouter. Doit contenir au moins un élément. Utilise [Lister les
biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md) pour trouver les ID.

## Réponse

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

**success** `boolean`

`true` lorsque les biomarqueurs ont été ajoutés au rendez-vous avec succès.

### Lire un `400`

Chaque `400` de validation de clôture ou de catalogue contient une phrase dans `message`. Un `400` de validation du corps ou
de microtainer contient uniquement `error`. Base ta logique sur `error`. En cas d'échec de
validation de clôture, `error` est une phrase. En cas d'échec lié au catalogue, `error` est un code machine :
`biomarker_not_priced` ou `biomarker_requires_position`.

**Validation de clôture** — l'ensemble ne peut être commandé proprement dans aucun laboratoire :

* `validation.failures[]` — présent uniquement en cas d'échec de validation de clôture (absent sur les simples
  erreurs de validation du corps). Une entrée par groupe de biomarqueurs qu'aucun laboratoire ne peut traiter, contenant les
  `biomarker_ids` en échec et `fix_options[]`, la plus petite option en premier. Le champ
  `add_biomarkers` (`{ id, name }`) de chaque option est un ensemble à ajouter EN ENTIER — garde tes biomarqueurs initiaux, ajoute ceux-là et
  réessaie. Un `fix_options` vide signifie qu'aucun ajout ne résoudra le problème ; supprime plutôt le biomarqueur.

**Biomarqueur non tarifé** — Aniva n'a pas fixé de prix pour ce biomarqueur. [Lister les
biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md) l'indique avec `price_cents: null`, ou l'omet quand il
s'agit d'un rapport ayant un composant non tarifé. `error` vaut `biomarker_not_priced`, et `biomarker_id` indique
le marqueur. Aucun autre biomarqueur ne corrige cette erreur, supprime donc le biomarqueur. Deux conditions rendent un
biomarqueur commandable : un laboratoire vers lequel Aniva peut router doit le fournir, **et** le catalogue Aniva doit
le tarifer.

**Biomarqueur restreint** — un biomarqueur vendu uniquement au sein d'une position, sans position qui le couvre dans
l'ensemble. `error` vaut `biomarker_requires_position`, `biomarker_id` indique le marqueur et `positions[]`
liste toutes les positions qui le vendent, la moins chère en premier. Ajoute tous les biomarqueurs de l'une d'entre elles. Consulte
[Tarification](https://docs.anivahealth.com/fr/concepts/pricing.md) pour le modèle, et `pricing.positions` sur [Obtenir un
biomarqueur](https://docs.anivahealth.com/fr/api/biomarkers/get-biomarker.md) pour la liste complète des membres d'une position.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | `biomarker_ids` vide ou non entier, l'ensemble échoue à la validation de clôture (`validation.failures`), il ajoute un biomarqueur qu'Aniva n'a pas tarifé (`error: "biomarker_not_priced"`), il contient un biomarqueur restreint qu'aucune position de l'ensemble ne couvre (`error: "biomarker_requires_position"`), ou, lors d'une prise de sang capillaire, les biomarqueurs ne rentrent pas dans leurs microtainers. |
| `403` | Accès refusé — scope manquant ou rendez-vous hors du contexte d'accès. |
| `404` | Rendez-vous ou un ou plusieurs biomarqueurs introuvables. |
| `409` | Conflit — les biomarqueurs ne peuvent plus être modifiés après la confirmation de la prise de sang. |
| `500` | Erreur interne du serveur. |

```bash cURL theme={null}
curl --request PATCH \
  --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": [45, 43, 42]
  }'
```

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

```json 400 (closure validation) theme={null}
{
  "error": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "message": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "validation": {
    "failures": [
      {
        "biomarker_ids": [45],
        "fix_options": [
          {
            "add_biomarkers": [
              { "id": 43, "name": "LDL Cholesterol" },
              { "id": 42, "name": "HDL Cholesterol" }
            ]
          }
        ]
      }
    ]
  }
}
```

```json 400 (biomarker Aniva has not priced) theme={null}
{
  "error": "biomarker_not_priced",
  "message": "Adrenaline, 24h urine carries no price in the catalog you can order from — GET /api/v1/biomarkers/1465 reports price_cents: null for it, and a marker with no price cannot be ordered.",
  "biomarker_id": 1465
}
```

```json 400 (biomarker sold only inside a position) theme={null}
{
  "error": "biomarker_requires_position",
  "message": "Mean Platelet Volume (MPV) is not sold on its own — it comes only inside a position. Add every biomarker of one of the positions listed here; the cheapest is \"Blood Count (extended)\".",
  "biomarker_id": 77,
  "positions": [
    {
      "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
      "name": "Blood Count (extended)",
      "price_cents": 460,
      "retail_cents": 529
    }
  ]
}
```

```json 400 (capillary, does not fit) theme={null}
{
  "error": "Some individual biomarkers need more than 150 µl of one lab's microtainer. Remove some of them."
}
```

```json 409 theme={null}
{
  "error": "Individual biomarkers cannot be modified after blood draw has been confirmed"
}
```

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


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