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

> Ajouter des panels de bilan sanguin à un rendez-vous

Ajoute un ou plusieurs panels de bilan sanguin à un rendez-vous existant. Tu peux appeler ce point de terminaison plusieurs fois pour composer la sélection de panels avant de confirmer la prise de sang.

Nécessite le scope `appointments_schedule`.

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

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. Si l'ensemble de panels obtenu enfreint cette règle, l'appel renvoie `400` avec
un message `error` et aucun panel n'est ajouté.

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant unique (UUID) du rendez-vous auquel ajouter des panels.

### Paramètres du corps

**panel\_ids** `string[]` *required*

Tableau d'UUID de panels à ajouter au rendez-vous. Doit contenir au moins un élément.

## Réponse

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

**success** `boolean`

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

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Erreur de validation — par ex. `panel_ids` est vide ou contient un UUID invalide — ou, lors d'une prise de sang capillaire, les biomarqueurs individuels ne rentrent plus dans leurs microtainers. |
| `403` | Accès refusé — ta clé API n'a pas accès à cette opération. |
| `404` | Rendez-vous ou un ou plusieurs panels introuvables. |
| `409` | Conflit — les panels ne peuvent plus être ajoutés après la confirmation de la prise de sang, ou un panel est un kit à domicile (`error_name: "home_kit_appointment_mismatch_error"`). Commande un kit à domicile via une [commande de kit à domicile](https://docs.anivahealth.com/fr/api/home-kit-orders/create-home-kit.md). |
| `500` | Erreur interne du serveur. |

### Panel de kit à domicile

Un kit à domicile est envoyé au patient et n'est pas prélevé lors d'un rendez-vous. Si un panel dans `panel_ids` est
un kit à domicile, l'appel renvoie `409` et n'ajoute aucun panel. Le corps contient ces champs :

**error** `string`

Motif lisible par un humain.

**error\_name** `string`

Toujours `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Le rendez-vous auquel le panel n'a pas été ajouté.

**panel\_id** `string`

Le panel de kit à domicile.

**home\_kit\_provider** `string | null`

Le fournisseur de kit à domicile du panel, ou `null` s'il n'est pas connu.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9",
      "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
    ]
  }'
```

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

```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": "Panels cannot be added after blood draw has been confirmed"
}
```

```json 409 (home kit panel) theme={null}
{
  "error": "Panel e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0 is a home kit (biomes) and cannot attach to appointment c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a — order it via home-kit orders",
  "error_name": "home_kit_appointment_mismatch_error",
  "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "panel_id": "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0",
  "home_kit_provider": "biomes"
}
```

```json 404 theme={null}
{
  "error": "Panels not found: e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
}
```


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